Microsoft Windows CE 3.0  


This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.

Block device drivers respond to this I/O control code to service the FAT file system's request for the name of the folder that the block device should be accessed as by end users. If the driver does not supply a name then the FAT file system will use the default name passed to it by FileSys.exe.


Handle to the block device.
Specifies this code.
Specifies a buffer allocated by the file system driver. The device driver fills this buffer with the folder name. The folder name must be a Unicode string.
Specifies the size of lpOutBuffer. This is always set to MAX_PATH where MAX_PATH includes the terminating NULL character.
Must be set by the device driver to the length of the returned string plus the terminating NULL character.


In Windows CE 3.0 and later, this code is now called IOCTL_DISK_GETNAME. The block device driver should fill the lpOutBufferbuffer with a Unicode string that represents the folder name to use for the block device. The FAT file system queries for a name each time a new block device is mounted. The block device driver can supply the same name for each query or can use different names. The FAT file system appends a number to the folder name if the supplied name is the same as an existing folder name. However, the FAT file system makes only a limited number of attempts to create a folder for the block device. If the block device driver does not support this I/O control code, the system's default name is used for all block devices mounted from the block device driver. A block device driver cannot use the name "Storage Card"; that name is reserved. If this name is returned, the request to mount the volume fails. Windows CE–based platforms that use languages other than English may have a different reserved folder name for block devices.


Runs on Versions Defined in Include Link to
Windows CE OS 1.0 and later      
Note   This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.

 Last updated on Tuesday, July 13, 2004

© 2004 Microsoft Corporation. All rights reserved.