WheaReportHwErrorDeviceDriver 函式 (ntddk.h)
若要報告硬體錯誤，驅動程式會呼叫 WheaReportHwErrorDeviceDriver 函 式。
語法
NTSTATUS WheaReportHwErrorDeviceDriver(
ULONG ErrorSourceId,
PDEVICE_OBJECT DeviceObject,
PUCHAR ErrorData,
ULONG ErrorDataLength,
LPGUID SectionTypeGuid,
WHEA_ERROR_SEVERITY ErrorSeverity,
LPSTR DeviceFriendlyName
);
參數
ErrorSourceId
呼叫 _WHEA_ERROR_SOURCE_INITIALIZE_DEVICE_DRIVER回 呼時所提供的錯誤來源標識碼 WHEA。
DeviceObject
與錯誤狀況相關聯的裝置物件的指標。
ErrorData
包含驅動程式硬體錯誤數據的緩衝區。 此資訊是硬體特定的，而且不得超過提供給 WheaAddErrorSourceDeviceDriver 的驅動程式所提供 MaxRawDataLength。
ErrorDataLength
ULONG 類型的值，指定錯誤數據的大小，以位元組為單位。
SectionTypeGuid
指定要報告的錯誤數據類型。 這可能是，但不需要是 UEFI 規格附錄 N 中定義的其中一個 GUID，在此情況下，錯誤資訊會符合其中一個指定的區段類型。 呼叫端也可以建立 GUID 和私用區段格式。
ErrorSeverity
型 別的 列舉值WHEA_ERROR_SEVERITY指定錯誤條件的嚴重性。
DeviceFriendlyName
長度上限為 20 個字節的選擇性字串， (包括 NULL 終止符) ，描述與錯誤狀況相關聯的裝置。 此資訊會複製到產生的 WHEA 錯誤記錄中，且僅供參考。 目的是將這項資訊放在錯誤記錄中，以便在建立事件記錄時，取用者可以輕鬆地針對裝置問題進行疑難解答。
傳回值
此函式方法會傳回STATUS_SUCCESS或適當的錯誤碼。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 10 (版本 1903) |
| 標頭 | ntddk.h |