BOOLEAN
IoIsTotalDeviceFailure(
IN NTSTATUS Status
);
IoIsTotalDeviceFailure determines whether a disk I/O error encountered while processing a request is unrecoverable.
Parameters
Status
Specifies the current NTSTATUS value, usually within a file system’s or fault-tolerant disk driver’s IoCompletion routine.
Return Value
IoIsTotalDeviceFailure returns TRUE if an I/O request failed because the physical device is out of commission.
Comments
This routine can be called only by higher-level drivers layered above a disk device driver.
If IoIsTotalDeviceFailure returns TRUE, a higher-level driver, such as a file system or fault-tolerant disk driver, usually logs an error before completing the IRP.
IoIsTotalDeviceFailure does not return TRUE for either of the status values STATUS_DEVICE_DATA_ERROR and STATUS_CRC_ERROR, which are assumed to indicate a sector failure rather than a total disk failure.
Callers of IoIsTotalDeviceFailure must be running at IRQL <= DISPATCH_LEVEL.
See Also
IoAllocateErrorLogEntry, IoRaiseHardError, IoRaiseInformationalHardError, IoWriteErrorLogEntry