Функция 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 или более поздней версии, записи ошибок должны быть предварительно выбраны.
Дополнительные сведения см. в статье Использование WHEA на Windows 10.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 10 версии 2004 |
| Верхняя часть | ntddk.h |