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

Подключаемый модуль PSHED GetInjectionCapabilities функция обратного вызова возвращает объединение возможностей внедрения ошибок, описывающих типы аппаратных ошибок, которые можно внедрить в аппаратную платформу.

Синтаксис

PSHED_PI_GET_INJECTION_CAPABILITIES PshedPiGetInjectionCapabilities;

NTSTATUS PshedPiGetInjectionCapabilities(
  [in, out, optional] PVOID PluginContext,
  [out]               PWHEA_ERROR_INJECTION_CAPABILITIES Capabilities
)
{...}

Параметры

[in, out, optional] PluginContext

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

[out] Capabilities

Указатель на объединение WHEA_ERROR_INJECTION_CAPABILITIES. Этот союз получает данные, описывающие типы аппаратных ошибок, которые можно внедрить в аппаратную платформу.

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

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

Возвращаемый код Описание
STATUS_SUCCESS Данные, описывающие типы аппаратных ошибок, которые можно внедрить в аппаратную платформу, были успешно возвращены в союзе WHEA_ERROR_INJECTION_CAPABILITIES, на который указывает параметр Возможности.
STATUS_UNSUCCESSFUL Произошла ошибка.

Замечания

Подключаемый модуль PSHED, который участвует в внедрении ошибок, задает callbacks.GetInjectionCapabilities и Callbacks.InjectError члены структуры WHEA_PSHED_PLUGIN_REGISTRATION_PACKET, чтобы указать на нее Функции обратного вызова GetInjectionCapabilities и InjectError, когда подключаемый модуль вызывает функцию PshedRegisterPlugin для регистрации в PSHED. Подключаемый модуль PSHED также должен задать флаг PshedFAErrorInjection в элементе FunctionalAreaMask элемента структуры WHEA_PSHED_PLUGIN_REGISTRATION_PACKET.

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

Требования

Требование Ценность
целевая платформа Настольный
заголовка ntddk.h (include Ntddk.h)
IRQL IRQL = DISPATCH_LEVEL

См. также

InjectError

PshedRegisterPlugin

WHEA_ERROR_INJECTION_CAPABILITIES

WHEA_PSHED_PLUGIN_REGISTRATION_PACKET