PSHED_PI_GET_INJECTION_CAPABILITIES função de retorno de chamada (ntddk.h)
O GetInjectionCapabilities de um plug-in PSHED função de retorno de chamada 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 Context membro 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.
Valor de retorno
Um plug-in PSHED GetInjectionCapabilities função de retorno de chamada 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. |
Observações
Um plug-in PSHED que participa da injeção de erro define os membros Callbacks.GetInjectionCapabilities e Callbacks.InjectError membros da estrutura WHEA_PSHED_PLUGIN_REGISTRATION_PACKET para apontar para sua GetInjectionCapabilities e InjectError funções de retorno de chamada quando o plug-in chama a função PshedRegisterPlugin para se registrar com o 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 investigação 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á o plug-in PSHED GetInjectionCapabilities função de retorno de chamada para recuperar informações sobre tipos adicionais de erros de hardware que podem ser injetados na plataforma de hardware.
Requisitos
| Requisito | Valor |
|---|---|
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | ntddk.h (inclua Ntddk.h) |
| IRQL | IRQL = DISPATCH_LEVEL |