функция обратного вызова PSHED_PI_GET_INJECTION_CAPABILITIES (ntddk.h)
Функция обратного вызова GetInjectionCapabilities подключаемого модуля PSHED возвращает объединение возможностей внедрения ошибок, описывающее типы аппаратных ошибок, которые можно внедрить в аппаратную платформу.
Синтаксис
PSHED_PI_GET_INJECTION_CAPABILITIES PshedPiGetInjectionCapabilities;
NTSTATUS PshedPiGetInjectionCapabilities(
[in, out, optional] PVOID PluginContext,
[out] PWHEA_ERROR_INJECTION_CAPABILITIES Capabilities
)
{...}
Параметры
[in, out, optional] PluginContext
Указатель на область контекста, указанную в элементе Contextструктуры WHEA_PSHED_PLUGIN_REGISTRATION_PACKET , когда подключаемый модуль PSHED вызывал функцию PshedRegisterPlugin для регистрации в PSHED.
[out] Capabilities
Указатель на объединение WHEA_ERROR_INJECTION_CAPABILITIES . Это объединение получает данные, описывающие типы ошибок оборудования, которые могут быть внедрены в аппаратную платформу.
Возвращаемое значение
Функция обратного вызова GetInjectionCapabilities подключаемого модуля PSHED возвращает один из следующих кодов NTSTATUS:
| Код возврата | Описание |
|---|---|
| STATUS_SUCCESS | Данные, описывающие типы аппаратных ошибок, которые можно внедрить в аппаратную платформу, были успешно возвращены в WHEA_ERROR_INJECTION_CAPABILITIES объединения, на который указывает параметр 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 вызывает функцию обратного вызова GetInjectionCapabilities подключаемого модуля PSHED для получения сведений о дополнительных типах аппаратных ошибок, которые можно внедрить в аппаратную платформу.
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Персональный компьютер |
| Верхняя часть | ntddk.h (включая Ntddk.h) |
| IRQL | IRQL = DISPATCH_LEVEL |