PSHED_PI_GET_INJECTION_CAPABILITIES função de retorno de chamada (ntddk.h)

Artigo
04/21/2023

A função de retorno de chamada GetInjectionCapabilities de um plug-in PSHED retorna uma união de recursos de injeção de erro que descreve os tipos de erros de hardware que podem ser injetados na plataforma de hardware.

Sintaxe

PSHED_PI_GET_INJECTION_CAPABILITIES PshedPiGetInjectionCapabilities;

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

Parâmetros

[in, out, optional] PluginContext

Um ponteiro para a área de contexto especificada no membro Context da estrutura WHEA_PSHED_PLUGIN_REGISTRATION_PACKET quando o plug-in PSHED chamou a função PshedRegisterPlugin para se registrar no PSHED.

[out] Capabilities

Um ponteiro para uma união WHEA_ERROR_INJECTION_CAPABILITIES . Essa união recebe os dados que descrevem os tipos de erros de hardware que podem ser injetados na plataforma de hardware.

Retornar valor

A função de retorno de chamada GetInjectionCapabilities de um plug-in PSHED retorna um dos seguintes códigos NTSTATUS:

Código de retorno	Descrição
STATUS_SUCCESS	Os dados que descrevem os tipos de erros de hardware que podem ser injetados na plataforma de hardware foram retornados com êxito na união WHEA_ERROR_INJECTION_CAPABILITIES apontada pelo parâmetro Capabilities .
STATUS_UNSUCCESSFUL	Ocorreu um erro.

Comentários

Um plug-in PSHED que participa da injeção de erro define os membros Callbacks.GetInjectionCapabilities e Callbacks.InjectError da estrutura WHEA_PSHED_PLUGIN_REGISTRATION_PACKET para apontar para suas funções de retorno de chamada GetInjectionCapabilities e InjectError quando o plug-in chama a função PshedRegisterPlugin para se registrar no PSHED. O plug-in PSHED também deve definir o sinalizador PshedFAErrorInjection no membro FunctionalAreaMask da estrutura WHEA_PSHED_PLUGIN_REGISTRATION_PACKET .

O kernel do Windows chama o PSHED para recuperar informações sobre os tipos de erros de hardware que podem ser injetados na plataforma de hardware em resposta a uma consulta de recursos de injeção de erro por um aplicativo de gerenciamento whea. Se um plug-in PSHED estiver registrado para participar da injeção de erro, o PSHED chamará a função de retorno de chamada GetInjectionCapabilities do plug-in PSHED para recuperar informações sobre tipos adicionais de erros de hardware que podem ser injetados na plataforma de hardware.