Previous

Next

Function MountDevice

Driver function MountDevice is called by RTFiles-32 when a device is mounted or remounted:

int RTFAPI MountDevice(void * DriveData, 
                       int    DeviceNumber, 
                       int    DeviceType, 
                       DWORD  Flags);

Parameters

DriveData

Pointer to the DeviceData found in the device list for the device.

DeviceNumber

DeviceNumber found in the device list for the device.

DeviceType

DeviceType found in the device list for the device.

Flags

Flags found in the device list for the device.

return value

If the function succeeds, it returns the device's sector size. If it fails, the return value is a negative error code. For removable disks, please see below for details.

This function may be called several times, in particular for removable devices. This function should perform all necessary initialization.

For removable disk devices, the return code of this function should be selected as follows:

• If the drive is not present, return RTF_NO_DRIVE.
• If the drive is present, but contains no media, return RTF_NO_MEDIA.
• If the drive is present and contains media, return the media's sector size ORed with value RTF_MOUNT_REMOVABLE (i.e., if the sector size is 512, return (512 | RTF_MOUNT_REMOVABLE).

Parameter Flags may contain additional device flag RTF_DEVICE_NO_2K_BUFFERS. If set, and the driver is able to determine that the sector size is 2048, it should return RTF_DRIVE_NOT_FOUND, even if the device is removable or present.

Structure RTFDriver

Function ShutDown