FsRtlIsTotalDeviceFailure function (ntddk.h)

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

Syntax

BOOLEAN FsRtlIsTotalDeviceFailure(
  NTSTATUS Status
);

Parameters

Status

[in] 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

   
Minimum supported client This routine is available on Microsoft Windows 2000 and later versions of Windows operating systems.
Target Platform Universal
Header ntddk.h (include Ntifs.h)
Library NtosKrnl.lib
DLL NtosKrnl.exe
IRQL Any level

See also

FsRtlIsNtstatusExpected

FsRtlNormalizeNtstatus

IoWriteErrorLogEntry