Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
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 | 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 |