FSH_FINDDUPHVPB - Locate equivalent hVPB
Purpose
This function provides the mechanism to identify a previous instance of a
volume during the FS_MOUNT process.
Calling Sequence
int far pascal FSH_FINDDUPHVPB(hVPB, phVPB)
unsigned short hVPB;
unsigned short far * phVPB;
Where
hVPB is the handle to the volume to be found.
phVPB is the pointer to where the handle of matching volume will be stored
.
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:
oERROR_NO_ITEMS
indicates there is no matching hVPB.
Remarks
When OS/2 is recognizing a volume, it calls the FSD to mount the volume.
At this point, the FSD may elect to allocate storage and buffer data for
that volume. The mount process will allocate a new VPB whenever the media
becomes uncertain, that is, when the device driver recognizes it can no
longer be certain the media is unchanged. This VPB cannot be collapsed
with a previously allocated VPB, because of a reinsertion of media, until
the FS_MOUNT call returns. The previous VPB, however, may have some cached
data that must be updated from the media (the media may have been written
while it was removed) FSH_FINDDUPHVPB allows the FSD to find this previous
occurrence of the volume in order to update the cached information for the
old VPB. Remember the newly created VPB will be unmounted if there is
another, older VPB for that volume.
Note: OS/2 does not validate input parameters. An FSD, therefore, should
call FSH_PROBEBUF where appropriate.
Created using Inf-PHP v.2 (c) 2003 Yuri Prokushev
Created using Inf-HTML v.0.9b (c) 1995 Peter Childs