Expand Minimize

IoIsErrorUserInduced routine

The IoIsErrorUserInduced routine determines whether an I/O error encountered while processing a request to a removable-media device was caused by the user.

Syntax


BOOLEAN IoIsErrorUserInduced(
  _In_  NTSTATUS Status
);

Parameters

Status [in]

Specifies the current NTSTATUS value, usually within the driver's DpcForIsr routine.

Return value

IoIsErrorUserInduced returns TRUE if an I/O request failed because of a user-induced error.

Remarks

This routine indicates whether an I/O request failed for one of the following user-correctable conditions:

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

If IoIsErrorUserInduced returns TRUE, the removable-media driver must call IoSetHardErrorOrVerifyDevice before completing the IRP.

Requirements

Version

Available starting with Windows 2000.

Header

Wdm.h (include Wdm.h, Ntddk.h, or Ntifs.h)

IRQL

Any level

See also

IoSetHardErrorOrVerifyDevice
IoAllocateErrorLogEntry
IoWriteErrorLogEntry

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft