FsRtlIsTotalDeviceFailure routine

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

Syntax


BOOLEAN FsRtlIsTotalDeviceFailure(
  _In_ 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

Target platform

Universal

Version

This routine is available on Microsoft Windows 2000 and later versions of Windows operating systems.

Header

Ntifs.h (include FltKernel.h or Ntifs.h)

Library

NtosKrnl.lib

DLL

NtosKrnl.exe

IRQL

Any level

See also

FsRtlIsNtstatusExpected
FsRtlNormalizeNtstatus
IoWriteErrorLogEntry

 

 

Send comments about this topic to Microsoft

Show: