共用方式為


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

另請參閱

WheaRemoveErrorSourceDeviceDriver

WheaReportHwErrorDeviceDriver

WheaCreateHwErrorReportDeviceDriver