PSHED_PI_GET_ERROR_SOURCE_INFO funzione di callback (ntddk.h)

Articolo
04/21/2023

La funzione di callback GetErrorSourceInfo di un plug-in PSHED restituisce una struttura del descrittore di origine degli errori che rappresenta una particolare origine di errore implementata dalla piattaforma hardware.

Sintassi

PSHED_PI_GET_ERROR_SOURCE_INFO PshedPiGetErrorSourceInfo;

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

Parametri

[in, out, optional] PluginContext

Puntatore all'area di contesto specificata nel membro Context della struttura WHEA_PSHED_PLUGIN_REGISTRATION_PACKET quando il plug-in PSHED ha chiamato la funzione PshedRegisterPlugin per registrarsi con PSHED.

[in, out] ErrorSource

Puntatore a una struttura WHEA_ERROR_SOURCE_DESCRIPTOR che rappresenta un'origine di errore specifica implementata dalla piattaforma hardware.

Valore restituito

Una funzione di callback GetErrorSourceInfo di un plug-in PSHED restituisce uno dei codici NTSTATUS seguenti:

Codice restituito	Descrizione
STATUS_SUCCESS	Le informazioni sull'origine degli errori sono state aggiornate correttamente.
STATUS_UNSUCCESSFUL	Si è verificato un errore.

Commenti

Un plug-in PSHED che partecipa all'individuazione dell'origine degli errori imposta il membro Callbacks.GetAllErrorSources e, facoltativamente, il membro Callbacks.GetErrorSourceInfo della struttura WHEA_PSHED_PLUGIN_REGISTRATION_PACKET in modo che punti alle relative funzioni di callback GetAllErrorSources e GetErrorSourceInfo quando il plug-in chiama la funzione PshedRegisterPlugin per registrarsi con PSHED. Il plug-in PSHED deve anche impostare il flag PshedFADiscovery nel membro FunctionalAreaMask della struttura WHEA_PSHED_PLUGIN_REGISTRATION_PACKET .

Il kernel di Windows chiama pshed per ottenere ulteriori dettagli su una determinata origine di errore. Ciò si verifica quando viene aggiunta una nuova origine di errore al sistema da un driver del bus. Ad esempio, quando il driver PCI individua un dispositivo PCI Express (PCIe) in grado di segnalare errori PCIe, segnala l'origine dell'errore al sistema operativo.

Se un plug-in PSHED viene registrato per partecipare all'individuazione dell'origine degli errori e ha implementato una funzione di callback GetErrorSourceInfo , dopo che PSHED ha aggiornato la struttura del descrittore di origine degli errori con le informazioni raccolte sull'origine degli errori, PSHED chiama la funzione di callback GetErrorSourceInfo del plug-in PSHED in modo che il plug-in PSHED possa fornire dettagli aggiuntivi sull'origine dell'errore. La funzione di callback GetErrorSourceInfo aggiorna il contenuto della struttura del descrittore di origine degli errori in modo che rappresenti in modo accurato l'origine dell'errore implementata dalla piattaforma hardware.