функция обратного вызова PSHED_PI_GET_ERROR_SOURCE_INFO (ntddk.h)

  • Статья

Функция обратного вызова GetErrorSourceInfo подключаемого модуля PSHED возвращает структуру дескриптора источника ошибок, представляющую конкретный источник ошибок, реализованный аппаратной платформой.

Синтаксис

PSHED_PI_GET_ERROR_SOURCE_INFO PshedPiGetErrorSourceInfo;

NTSTATUS PshedPiGetErrorSourceInfo(
  [in, out, optional] PVOID PluginContext,
  [in, out]           PWHEA_ERROR_SOURCE_DESCRIPTOR ErrorSource
)
{...}

Параметры

[in, out, optional] PluginContext

Указатель на область контекста, указанную в элементе Contextструктуры WHEA_PSHED_PLUGIN_REGISTRATION_PACKET , когда подключаемый модуль PSHED вызывал функцию PshedRegisterPlugin для регистрации в PSHED.

[in, out] ErrorSource

Указатель на структуру WHEA_ERROR_SOURCE_DESCRIPTOR , представляющую конкретный источник ошибок, реализованный аппаратной платформой.

Возвращаемое значение

Функция обратного вызова GetErrorSourceInfo подключаемого модуля PSHED возвращает один из следующих кодов NTSTATUS:

Код возврата Описание
STATUS_SUCCESS Сведения об источнике ошибки успешно обновлены.
STATUS_UNSUCCESSFUL Произошла ошибка.

Комментарии

Подключаемый модуль PSHED, участвующий в обнаружении источника ошибок, задает член Callbacks.GetAllErrorSources и, при необходимости, член Callbacks.GetErrorSourceInfoWHEA_PSHED_PLUGIN_REGISTRATION_PACKET , чтобы указать на его функции обратного вызова GetAllErrorSources и GetErrorSourceInfo , когда подключаемый модуль вызывает функцию PshedRegisterPlugin для регистрации в PSHED. Подключаемый модуль PSHED также должен установить флаг PshedFADiscovery в элементе FunctionalAreaMask структуры WHEA_PSHED_PLUGIN_REGISTRATION_PACKET .

Ядро Windows вызывает PSHED для получения дополнительных сведений об определенном источнике ошибок. Это происходит при добавлении нового источника ошибок в систему водителем автобуса. Например, когда драйвер PCI обнаруживает устройство PCI Express (PCIe), которое может сообщать об ошибках PCIe, он сообщает об источнике ошибок в операционную систему.

Если подключаемый модуль PSHED зарегистрирован для участия в обнаружении источника ошибок и он реализовал функцию обратного вызова GetErrorSourceInfo , после того как PSHED обновил структуру дескриптора источника ошибок с собранными сведениями об источнике ошибок, PSHED вызывает функцию обратного вызова GetErrorSourceInfo подключаемого модуля PSHED, чтобы подключаемый модуль PSHED мог предоставить дополнительные сведения об источнике ошибок. Функция обратного вызова GetErrorSourceInfo обновляет содержимое структуры дескриптора источника ошибок, чтобы она точно представляла источник ошибок по мере реализации аппаратной платформой.

Требования

Требование Значение
Целевая платформа Персональный компьютер
Верхняя часть ntddk.h (включая Ntddk.h)
IRQL IRQL = DISPATCH_LEVEL

См. также раздел

GetAllErrorSources

PshedRegisterPlugin

WHEA_ERROR_SOURCE_DESCRIPTOR

WHEA_PSHED_PLUGIN_REGISTRATION_PACKET