IoSetDeviceToVerify 函数 (ntifs.h)
IoSetDeviceToVerify 例程设置在指定线程中验证的设备对象。 指定的设备对象表示可移动媒体设备。
语法
void IoSetDeviceToVerify(
[in] PETHREAD Thread,
[in, optional] PDEVICE_OBJECT DeviceObject
);
参数
[in] Thread
指向线程的 ETHREAD 线程对象结构的指针。
[in, optional] DeviceObject
指向 DEVICE_OBJECT 结构的指针,该结构标识可移动媒体设备的设备对象。 DeviceObject 可以为 NULL。
返回值
无
备注
在使用 IoSetDeviceToVerify 和 IoVerifyVolume 之前,驱动程序编写器应研究在 FASTFAT 示例中使用这些例程的方式。 有关其他信息,另请参阅 支持可移动媒体。
调用 IoSetDeviceToVerify 以指示需要验证表示可移动媒体设备的给定设备对象。 调用 IoGetDeviceToVerify 以获取设备对象,该对象是给定线程的 I/O 请求的目标。
文件系统驱动程序在收到来自基础可移动媒体设备驱动程序的通知时,必须验证卷,该通知表明该媒体自上次访问目标设备以来似乎已更改。 当较低的设备返回STATUS_VERIFY_REQUIRED时,文件系统通常会调用 IoSetDeviceToVerify 和 IoVerifyVolume 。
要求
要求 | 值 |
---|---|
目标平台 | 通用 |
标头 | ntifs.h (包括 Ntifs.h) |
Library | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | <= DISPATCH_LEVEL |
DDI 符合性规则 | IrqlIoDispatch (wdm) |