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 |