IoSetDeviceToVerify function (ntifs.h)

Article
02/22/2024

The IoSetDeviceToVerify routine sets the device object to be verified in the specified thread. The specified device object represents a removable media device.

Syntax

void IoSetDeviceToVerify(
  [in]           PETHREAD       Thread,
  [in, optional] PDEVICE_OBJECT DeviceObject
);

Parameters

[in] Thread

Pointer to an ETHREAD thread object structure for the thread.

[in, optional] DeviceObject

Pointer to a DEVICE_OBJECT structure that identifies the device object for a removable-media device. DeviceObject can be NULL.

Return value

None

Remarks

Before using IoSetDeviceToVerify and IoVerifyVolume, driver writers should study the way these routines are used in the FASTFAT sample. For additional information, see also Supporting Removable Media.

IoSetDeviceToVerify is called to indicate that a given device object, representing a removable-media device, needs to be verified. Call IoGetDeviceToVerify to obtain the device object that is the target of the given thread's I/O request.

A file system driver must verify a volume when it receives notification from an underlying removable-media device driver that the media appears to have changed since the last access to the target device. The file system typically calls IoSetDeviceToVerify and IoVerifyVolume when the lower device returns STATUS_VERIFY_REQUIRED.

Requirements

Requirement	Value
Target Platform	Universal
Header	ntifs.h (include Ntifs.h)
Library	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= DISPATCH_LEVEL
DDI compliance rules	IrqlIoDispatch(wdm)