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 |