FSH_SETVOLUME
Purpose
This function provides the mechanism for assuring that a desired volume is in a removable media drive before I/O is done to the drive.
Calling Sequence
int far pascal FSH_SETVOLUME(hVPB , fControl) unsigned short hVPB; unsigned short fControl;
Where
hVPB is the volume handle for the source of I/O.
fControl is the bit mask of pop-up control actions:
| Bit 0 off | indicates volume change pop-up desired |
| Bit 0 on | indicates no volume change pop-up |
| All other bits are reserved and must be zero. | |
Returns
If no error is detected, a zero error code is returned. If an error is detected, one of the following error codes is returned:
- ERROR_VOLUME_CHANGED – is an indication that removable media volume change has occurred.
- ERROR_INVALID_PARAMETER – the fControl flag word has reserved bits on.
Remarks
This routine is used by the FSH_CALLDRIVER routine to insure that the desired volume is in a removable media drive. FSDs can use it for the same purpose.
FSH_SETVOLUME may block.
Note: OS/2 does not validate input parameters. An FSD, therefore, should call FSH_PROBEBUF where appropriate.