FsRtlIsTotalDeviceFailure function (ntddk.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 | 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
Feedback
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.
Submit and view feedback for