Previous

Next

Function MediaChanged

Driver function MediaChanged should check whether the volume in the drive has been removed or exchanged, if such a check is supported by the hardware:

int RTFAPI MediaChanged(void * DriveData);

Parameters

DriveData

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

return value

If no media change has occurred, RTF_NO_ERROR is returned; otherwise RTF_MEDIA_CHANGED.

If the driver implements access to a fixed media device or the hardware is unable to detect media changes, the function should return RTF_NO_ERROR. If, however, a media change is detected, error code RTF_MEDIA_CHANGED should be returned. Note that function MediaChanged is called only occasionally by RTFiles-32. ReadSectors and WriteSectors should check for media changes and return RTF_MEDIA_CHANGED, if detected.

Function WriteSectors

Function DiscardSectors