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

Статья
02/07/2025

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

Синтаксис

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

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

[in, out] ErrorSource

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

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

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

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

Замечания

Подключаемый модуль PSHED, который участвует в обнаружении источника ошибок, задает элемент Callbacks.GetAllErrorSources и, При необходимости callbacks.GetErrorSourceInfo член структуры WHEA_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 вызывает функцию обратного вызова GetErrorSource Info для PSHED, чтобы подключаемый модуль PSHED может предоставить дополнительные сведения об источнике ошибок. Функция обратного вызова GetErrorSourceInfo обновляет содержимое структуры дескриптора источника ошибки таким образом, чтобы она точно представляла источник ошибок при реализации аппаратной платформы.