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

Artigo
02/26/2024

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

Sintaxe

PSHED_PI_ENABLE_ERROR_SOURCE PshedPiEnableErrorSource;

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

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.

[in] ErrorSource

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

Retornar valor

A função de retorno de chamada EnableErrorSource 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 habilitada com êxito.
STATUS_NOT_SUPPORTED	O plug-in PSHED não dá suporte à habilitação da fonte 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 habilitar cada uma das fontes de erro que foram relatadas durante a descoberta da origem do erro. O kernel do Windows também chama o PSHED para habilitar uma fonte de erro em resposta a uma solicitação de habilitaçã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 EnableErrorSource do plug-in PSHED para dar ao plug-in PSHED a oportunidade de habilitar a origem do erro. Se a função de retorno de chamada EnableErrorSource retornar STATUS_NOT_SUPPORTED, o PSHED habilitará a origem do erro. Caso contrário, o PSHED retornará apenas o valor retornado pela função de retorno de chamada EnableErrorSource .

Se o plug-in PSHED habilitar com êxito a origem do erro, o PSHED atualizará a estrutura WHEA_ERROR_SOURCE_DESCRIPTOR em nome do plug-in PSHED após a chamada à função de retorno de chamada EnableErrorSource do plug-in PSHED. A função de retorno de chamada EnableErrorSource de um plug-in PSHED não deve modificar o descritor de origem do erro.