IoIsTotalDeviceFailure

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.