FsRtlIsTotalDeviceFailure function

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

Syntax

NTKERNELAPI BOOLEAN FsRtlIsTotalDeviceFailure(
  NTSTATUS Status
);

Parameters

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

   
Windows version 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