Expand Minimize

IoGetDeviceToVerify routine

The IoGetDeviceToVerify routine returns a pointer to the device object, representing a removable-media device, that is the target of the given thread's I/O request.

Syntax


PDEVICE_OBJECT IoGetDeviceToVerify(
  _In_  PETHREAD Thread
);

Parameters

Thread [in]

Pointer to the thread for which a highest-level driver is attempting to verify the validity of the media on which the thread has opened a file.

Return value

IoGetDeviceToVerify returns a pointer to the device object representing a device on which the media should be verified, or it returns NULL.

Remarks

In general, highest-level drivers, particularly file systems, are most likely to call this routine.

An underlying removable-media device driver is responsible for notifying higher-level drivers, particularly the file system, when the media appears to have changed since the last access to the target device. For more information, see Supporting Removable Media.

Requirements

Version

Available starting with Windows 2000.

Header

Ntifs.h (include Ntifs.h)

Library

Ntoskrnl.lib

IRQL

<= DISPATCH_LEVEL

DDI compliance rules

IrqlIoDispatch

See also

IoIsErrorUserInduced
IoSetHardErrorOrVerifyDevice
PsGetCurrentThread
IoSetDeviceToVerify

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft