WheaAddErrorSourceDeviceDriver 函式 (ntddk.h)
裝置驅動程式會呼叫 WheaAddErrorSourceDeviceDriver 以新增錯誤來源。
語法
NTSTATUS WheaAddErrorSourceDeviceDriver(
PVOID Context,
PWHEA_ERROR_SOURCE_CONFIGURATION_DEVICE_DRIVER Configuration,
ULONG NumberPreallocatedErrorReports
);
參數
Context
呼叫端配置內容的選擇性指標。 WHEA 提供內容做為驅動程式提供的回呼例程的參數。 可以是 NULL。
Configuration
包含一組驅動程式提供的回呼例程之類型 WHEA_ERROR_SOURCE_CONFIGURATION_DEVICE_DRIVER 結構的指標。
NumberPreallocatedErrorReports
ULONG 類型的值,指定要預先配置的記錄數目。 如需詳細資訊,請參閱。
傳回值
如果新增錯誤來源,則此函式方法會傳回STATUS_SUCCESS。 否則,它可以傳回下列其中一項:
- STATUS_INVALID_PARAMETER:設定遺漏初始化和/或取消初始化回呼指標。
- STATUS_INVALID_PARAMETER_2:提交無效版本的設定。
- STATUS_INSUFFICIENT_RESOURCES:WHEA 無法為錯誤來源及其記錄配置空間。
言論
若要移除錯誤來源,驅動程式會呼叫 WheaRemoveErrorSourceDeviceDriver。
WHEA 可以預先配置記憶體,找出將在高 IRQL 報告的錯誤(也就是在裝置中斷的內容中)。 對於在PASSIVE_LEVEL回報的錯誤來源,不需要預先配置,但如果裝置驅動程式在DISPATCH_LEVEL或更高版本報告錯誤來源的錯誤來源,則必須預先配置錯誤記錄。
如需詳細資訊,請參閱在 Windows 10 上使用 WHEA 。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | Windows 10 版本 2004 |
標頭 | ntddk.h |