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

Artigo
04/21/2023

A função de retorno de chamada GetErrorSourceInfo de um plug-in PSHED retorna uma estrutura de descritor de origem de erro que representa uma fonte de erro específica implementada pela plataforma de hardware.

Sintaxe

PSHED_PI_GET_ERROR_SOURCE_INFO PshedPiGetErrorSourceInfo;

NTSTATUS PshedPiGetErrorSourceInfo(
  [in, out, optional] PVOID PluginContext,
  [in, out]           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, out] ErrorSource

Um ponteiro para uma estrutura de WHEA_ERROR_SOURCE_DESCRIPTOR que representa uma fonte de erro específica implementada pela plataforma de hardware.

Retornar valor

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

Código de retorno	Descrição
STATUS_SUCCESS	As informações de origem do erro foram atualizadas com êxito.
STATUS_UNSUCCESSFUL	Ocorreu um erro.

Comentários

Um plug-in PSHED que participa da descoberta de origem de erro define o membro Callbacks.GetAllErrorSources e, opcionalmente, o membro Callbacks.GetErrorSourceInfo da estrutura WHEA_PSHED_PLUGIN_REGISTRATION_PACKET para apontar para suas funções de retorno de chamada GetAllErrorSources e GetErrorSourceInfo 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 PshedFADiscovery no membro FunctionalAreaMask da estrutura WHEA_PSHED_PLUGIN_REGISTRATION_PACKET .

O kernel do Windows chama o PSHED para obter detalhes adicionais sobre uma fonte de erro específica. Isso ocorre quando uma nova fonte de erro é adicionada ao sistema por um motorista de ônibus. Por exemplo, quando o driver PCI descobre um dispositivo PCI Express (PCIe) capaz de relatar erros pcie, ele relata a origem do erro para o sistema operacional.

Se um plug-in PSHED estiver registrado para participar da descoberta da fonte de erro e tiver implementado uma função de retorno de chamada GetErrorSourceInfo , depois que o PSHED tiver atualizado a estrutura do descritor de origem do erro com as informações coletadas sobre a origem do erro, o PSHED chamará a função de retorno de chamada GetErrorSourceInfo do plug-in PSHED para que o plug-in PSHED possa fornecer detalhes adicionais sobre a origem do erro. A função de retorno de chamada GetErrorSourceInfo atualiza o conteúdo da estrutura do descritor de origem de erro para que ela represente com precisão a origem do erro conforme ela é implementada pela plataforma de hardware.