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 |