FSD Functions (Windows CE 5.0)
The following table shows the file system driver (FSD) functions along with a description of the purpose of each.
| Programming element | Description |
|---|---|
| CeFsIoControl | This function sends an IOCTL to an FSD. It may not be supported by all file system drivers, and not all implementations will support all IOCTL codes. |
| CeResyncFilesys | This function causes a file system driver to remount a device because of a media change. |
| FSD_HookVolume | This function is the entry point called by the Storage Manager when it loads a file system filter. |
| FSD_MountDisk | This function is called by the Device Manager to mount the specified disk containing a file system of the type defined. |
| FSD_UnhookVolume | This function is called by the Storage Manager when it unloads a file system filter. |
| FSD_UnmountDisk | This function is called by the Device Manager to unmount the specified disk containing a file system of the type defined by the file system driver (FSD). |
| FSDMGR_CreateFileHandle | This function is called by an FSD to create a handle for a specified file. |
| FSDMGR_CreateSearchHandle | This function creates search or find handles. It is called by an FSD. |
| FSDMGR_DeviceHandleToHDSK | This function converts a true device handle into an HDSK for use in subsequent calls to the FSDMGR helper functions. |
| FSDMGR_DiskIoControl | This function is called by an FSD to access DeviceIoControl functions exported by a block driver. |
| FSDMGR_GetDiskInfo | This function gets disk information. It is called by an FSD. |
| FSDMGR_GetRegistryFlag | This function is called by an FSD to read a flag based on a value from the registry. |
| FSDMGR_GetRegistryString | This function is called by an FSD to read a string value from the registry. |
| FSDMGR_GetRegistryValue | This function is called by an FSD to read a numeric value from the registry. |
| FSDMGR_GetVolumeName | This function gets the name of a volume, given its handle. |
| FSDMGR_ReadDisk | This function reads sectors from a disk. |
| FSDMGR_ReadDiskEx | This function reads sectors from a disk into discontinuous buffers. |
| FSDMGR_RegisterVolume | This function registers a volume on a disk. |
| FSDMGR_WriteDisk | This function writes sectors to a disk. |
| FSDMGR_WriteDiskEx | This function writes sectors to a disk from discontinuous buffers. |
| FSDMGR_AcquireFileLock | This function is a helper provided by FSDMGR to simplify the implementation of MyFSD_LockFileEx in an FSD. |
| FSDMGR_RemoveFileLock | This function is a helper provided by FSDMGR to simplify the implementation of MyFSD_UnlockFileEx in an FSD. |
| FSDMGR_EmptyLockContainer | This function is a helper provided by FSDMGR to free all blocked threads waiting to install a lock on a particular file. |
| FSDMGR_OpenFileLockState | This function is a helper macro provided by FSDMGR to initialize a new FILELOCKSTATE structure. |
| FSDMGR_CloseFileLockState | This function is a helper macro provided to free a FILELOCKSTATE structure. |
| LoadFSD | This function is called by a device driver to load its associated FSD. This function is obsolete in Windows CE .NET 4.0 and later. Instead, place a storage class identifier in the device driver registry setting to notify the Storage Manager of the block driver being loaded. The Storage Manager will then parse the partitions and load the appropriate file system. |
| LoadFSDEx | This function is called by a device driver to load its associated FSD. This function is obsolete in Windows CE .NET 4.0 and later. Instead, place a storage class identifier in the device driver registry setting to notify the Storage Manager of the block driver being loaded. The Storage Manager will then parse the partitions and load the appropriate file system. |
| MyFSD_CloseFile | This function is called when an application closes an open handle for a file that was open on an installable file system. |
| MyFSD_CloseVolume | This function closes a volume on a device that has an installable file system. |
| MyFSD_CreateDirectoryW | This function is called by the FSD Manager to create a new directory in an installable file system. |
| MyFSD_CreateFileW | This function creates, opens, or truncates a file, pipe, communications resource, disk device, or console in an installable file system. |
| MyFSD_DeleteAndRenameFileW | This function deletes the source file, pwsOldFileName, after it copies the content of the source file to the destination file, pwsNewFileName, in an installable file system. |
| MyFSD_DeleteFileW | This function deletes an existing file from an installable file system. The application does not call this function directly. Instead, use the corresponding standard Windows-based desktop platform function DeleteFilecerefDeleteFile. The FSD Manager determines the file system type and calls the MyFSD_DeleteFileW implementation of the function. |
| MyFSD_DeviceIoControl | This function sends an IOCTL directly to a specified device driver, causing the corresponding device to perform the specified operation. The application does not call this function directly. Instead, use the corresponding standard Windows-based desktop platform function DeviceIoControl. The FSD Manager determines the file system type and calls the MyFSD_DeviceIoControl implementation of the function. |
| MyFSD_FindClose | This function closes the specified search handle. The MyFSD_FindFirstFileW and MyFSD_FindNextFileW functions use the search handle to locate files with names that match a specified name. The application does not call this function directly. Instead, use the corresponding standard Windows-based desktop platform function FindClose. The FSD Manager determines the file system type and calls the MyFSD_FindClose implementation of the function. |
| MyFSD_FindFirstFileW | This function searches a directory for a file in an installable file system whose name matches the specified file name. This function also examines subdirectory names as well as file names. The application does not call this function directly. Instead, use the corresponding standard Windows-based desktop platform function FindFirstFile. The FSD Manager determines the file system type and calls the MyFSD_FindFirstFileW implementation of the function. |
| MyFSD_FindNextFileW | This function continues a file search from a previous call to the MyFSD_FindFirstFileW function. The application does not call this function directly. Instead, use the corresponding standard Win32 function FindNextFile. The FSD Manager determines the file system type and calls the MyFSD_FindNextFileW implementation of the function. |
| MyFSD_FlushFileBuffers | This function clears the buffers for the specified file in an installable file system and causes all buffered data to be written to the file. The application does not call this function directly. Instead, use the corresponding standard Win32 function FlushFileBuffers. The file system driver (FSD) Manager determines the file system type and calls the MyFSD_FlushFileBuffers implementation of the function. |
| MyFSD_FsIoControl | This function can be exported by an FSD and processes IOCTL codes for a file system volume. An application should not call this function directly. Instead, the corresponding standard function CeFsIoControl should be used. The FSD manager determines the file system type and calls the MyFSD_FsIoControl implementation of the function. |
| MyFSD_GetDiskFreeSpaceW | This function obtains information about the amount of space available on a disk volume in an installable file system. Applications should not call this function directly. Instead, use the corresponding standard Windows-based desktop platform function GetDiskFreeSpaceEx. The FSD Manager determines the file system type and calls the MyFSD_GetDiskFreeSpaceW implementation of the function. |
| MyFSD_GetFileAttributesW | This function returns attributes for a specified file or directory in an installable file system. The application does not call this function directly. Instead, use the corresponding standard Windows-based desktop platform function GetFileAttributes. The FSD Manager determines the file system type and calls the MyFSD_GetFileAttributesW version of the function. |
| MyFSD_GetFileInformationByHandle | This function retrieves information about the specified file in an installable file system. The application does not call this function directly. Instead, use the corresponding standard Windows-based desktop platform function GetFileInformationByHandle. The FSD Manager determines the file system type and calls the MyFSD_GetFileInformationByHandle implementation of the function. |
| MyFSD_GetFileSize | This function retrieves the size, in bytes, of the specified file that resides in an installable file system. The application does not call this function directly. Instead, use the corresponding standard Windows-based desktop platform function GetFileSize. The FSD Manager determines the file system type and calls the MyFSD_GetFileSize implementation of the function. |
| MyFSD_GetFileTime | This function retrieves the date and time that a file in an installable file system was created, last accessed, and last modified. The application does not call this function directly. Instead, use the corresponding standard Windows-based desktop platform function GetFileTime. The FSD Manager determines the file system type and calls the MyFSD_GetFileTime implementation of the function. |
| MyFSD_GetVolumeInfo | This function retrieves information about an FSD volume. |
| MyFSD_MountDisk | This function mounts the specified disk containing a file system of the type defined by an FSD. This function is exported by an implementation of an FSD and is called indirectly by the file system driver manager (FSDMGR). |
| MyFSD_MoveFileW | This function renames an existing file or a directory, including all its children, that resides in an installable file system. The application does not call this function directly. Instead, use the corresponding standard Windows-based desktop platform function MoveFile. The FSD Manager determines the file system type and calls the MyFSD_MoveFileW implementation of the function. |
| MyFSD_Notify | This function, an event notification handler, is called by the application to notify an FSD on a per-volume basis. |
| MyFSD_ReadFile | This function reads data from a file, starting at the position indicated by the file pointer. |
| MYFSD_ReadFileScatter | This function reads data from a file and stores it in an array of buffers. |
| MyFSD_ReadFileWithSeek | This function reads data from a file, starting at the position indicated by the caller. |
| MyFSD_RegisterFileSystemFunction | This function is called by the FSD Manager to register a file or folder change notification function with an FSD to ensure that the shell maintains an accurate view of the file system. |
| MyFSD_RemoveDirectoryW | This function deletes an existing empty directory from an installable file system. |
| MyFSD_SetEndOfFile | This function moves the end of file (EOF) position for the specified file in an installable file system to the current position of the file pointer. |
| MyFSD_SetFileAttributesW | This function sets the attributes of a file that resides in an installable file system. |
| MyFSD_SetFilePointer | This function moves the file position of an open file in an installable file system. |
| MyFSD_SetFileTime | This function sets the date and time that a file in an installable file system was created, last accessed, or last modified. |
| MyFSD_UnmountDisk | This function unmounts the specified disk containing a file system of the type defined by an FSD. |
| MyFSD_WriteFile | This function writes data to a file in an installable file system. |
| MyFSD_WriteFileWithSeek | This function writes data to a file in an installable file system. |
| MyFSD_WriteFileGather | This function gathers data from a set of buffers and writes it to a file. |
| MyFSD_LockFileEx | This function locks the specified file for exclusive access by the calling process. |
| MyFSD_UnlockFileEx | This function unlocks a region in an open file. Unlocking a region enables other processes to access the region. |
See Also
Send Feedback on this topic to the authors