IoIsErrorUserInduced 宏 (wdm.h)

IoIsErrorUserInduced 例程确定在处理对可移动媒体设备的请求时遇到的 I/O 错误是否由用户引起。

语法

BOOLEAN IoIsErrorUserInduced(
   Status
);

参数

[in] Status

指定当前 NTSTATUS 值,通常位于驱动程序的 DpcForIsr 例程中。

返回值

备注

如果 I/O 请求因用户引起的错误而失败,IoIsErrorUserInduced 将返回 TRUE。

此例程指示 I/O 请求是否因以下用户可更正条件之一而失败:

STATUS_DEVICE_NOT_READY

STATUS_IO_TIMEOUT

STATUS_MEDIA_WRITE_PROTECTED

STATUS_NO_MEDIA_IN_DEVICE

STATUS_UNRECOGNIZED_MEDIA

STATUS_VERIFY_REQUIRED

STATUS_WRONG_VOLUME

如果 IoIsErrorUserInduced 返回 TRUE,则可移动媒体驱动程序必须在完成 IRP 之前调用 IoSetHardErrorOrVerifyDevice

要求

要求
最低受支持的客户端 从 Windows 2000 开始可用。
目标平台 桌面
标头 wdm.h(包括 Wdm.h、Ntddk.h、Ntifs.h)
IRQL 任何级别

另请参阅

IoAllocateErrorLogEntry

IoSetHardErrorOrVerifyDevice

IoWriteErrorLogEntry