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

Artigo
04/21/2023

A função de retorno de chamada SetErrorSourceInfo de um plug-in PSHED configura uma fonte de erro.

Sintaxe

PSHED_PI_SET_ERROR_SOURCE_INFO PshedPiSetErrorSourceInfo;

NTSTATUS PshedPiSetErrorSourceInfo(
  [in, out, optional] PVOID PluginContext,
  [in]                PWHEA_ERROR_SOURCE_DESCRIPTOR ErrorSource
)
{...}

Parâmetros

[in, out, optional] PluginContext

Um ponteiro para a área de contexto que foi 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.

[in] ErrorSource

Um ponteiro para uma estrutura WHEA_ERROR_SOURCE_DESCRIPTOR que descreve a origem do erro que está sendo configurada.

Retornar valor

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

Código de retorno	Descrição
STATUS_SUCCESS	A origem do erro foi configurada com êxito.
STATUS_NOT_SUPPORTED	O plug-in PSHED não dá suporte à configuração da origem de erro especificada.
STATUS_UNSUCCESSFUL	Ocorreu um erro.

Comentários

Um plug-in PSHED que participa do controle do código-fonte de erro define o Callbacks.SetErrorSourceInfo, Os membros Callbacks.EnableErrorSource e Callbacks.DisableErrorSource da estrutura WHEA_PSHED_PLUGIN_REGISTRATION_PACKET para apontar para suas funções de retorno de chamada SetErrorSourceInfo, EnableErrorSource e DisableErrorSource quando o plug-in chama a função PshedRegisterPlugin para se registrar no PSHED. O plug-in PSHED também deve definir o sinalizador PshedFAErrorSourceControl no membro FunctionalAreaMask da estrutura WHEA_PSHED_PLUGIN_REGISTRATION_PACKET.

O kernel do Windows chama o PSHED para configurar uma fonte de erro em resposta a uma solicitação de configuração de origem de erro por um aplicativo de gerenciamento WHEA. Se um plug-in PSHED estiver registrado para participar do controle do código-fonte de erro, o PSHED chamará a função de retorno de chamada SetErrorSourceInfo do plug-in PSHED para dar ao plug-in PSHED a oportunidade de executar a operação de configuração de origem do erro. Os dados de configuração da origem do erro estão incluídos na estrutura WHEA_ERROR_SOURCE_DESCRIPTOR que é apontada pelo parâmetro ErrorSource .

Se o plug-in PSHED não der suporte à configuração da origem de erro especificada, a função de retorno de chamada SetErrorSourceInfo retornará STATUS_NOT_SUPPORTED. Nessa situação, o PSHED executa a operação de configuração de origem de erro solicitada.

Se o plug-in PSHED der suporte à configuração da fonte de erro especificada, a função de retorno de chamada SetErrorSourceInfo deverá salvar os dados de configuração da fonte de erro no registro, nas tabelas bios do sistema ou em alguma outra forma de armazenamento de dados não volátil que esteja disponível para a fonte de erro. A forma específica de armazenamento de dados não volátil usada por uma fonte de erro para armazenar os dados de configuração da fonte de erro é específica da implementação. A função de retorno de chamada SetErrorSourceInfo deve aplicar os dados de configuração à fonte de erro de forma que as alterações de configuração entrem em vigor na próxima vez que o sistema for reiniciado. Quando o sistema é reiniciado, o plug-in PSHED deve relatar os novos dados de configuração de origem de erro para a fonte de erro para o sistema operacional durante a descoberta da origem do erro.