FsRtlIsTotalDeviceFailure function (ntifs.h)

The FsRtlIsTotalDeviceFailure routine determines whether a media or other hardware failure has occurred.

Syntax

BOOLEAN FsRtlIsTotalDeviceFailure(
  [in] NTSTATUS Status
);

Parameters

[in] Status

Specifies the current NTSTATUS value, usually within a file system's or fault-tolerant disk driver's completion routine.

Return value

The FsRtlIsTotalDeviceFailure routine returns TRUE if an I/O request failed because the physical device has failed.

Remarks

If FsRtlIsTotalDeviceFailure returns TRUE, a higher-level driver, such as a file system or fault-tolerant disk driver, usually logs an error before completing the IRP.

FsRtlIsTotalDeviceFailure 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.

For more information about handling device failure, see Error Handling.

Requirements

Requirement Value
Minimum supported client Windows 2000
Target Platform Universal
Header ntifs.h (include Ntifs.h)
Library NtosKrnl.lib
DLL NtosKrnl.exe
IRQL Any level

See also

FsRtlIsNtstatusExpected

FsRtlNormalizeNtstatus

IoWriteErrorLogEntry