 Important: |
|---|
| 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.
Parameters
- hDevice
- Handle to the block device.
- dwIoControlCode
- Specifies this code.
- lpInBuffer
- NULL.
- nInBufferSize
- 0.
- lpOutBuffer
- 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.
- nOutBufferSize
- Specifies the size of lpOutBuffer. This is always set to MAX_PATH where MAX_PATH includes the terminating NULL character.
- lpBytesReturned
- Must be set by the device driver to the length of the returned string plus the terminating NULL character.
- lpOverlapped
- NULL.
Remarks
In Windows CE versions prior to 3.0, this code was called DISK_IOCTL_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.
Requirements
Runs on Versions Defined in Include Link to Windows CE OS 3.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