PSHED_PI_GET_ERROR_SOURCE_INFO funzione di callback (ntddk.h)

Articolo
02/07/2025

Un plug-in PSHED GetErrorSourceInfo funzione di callback 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 Context membro della struttura WHEA_PSHED_PLUGIN_REGISTRATION_PACKET quando il plug-in PSHED ha chiamato il PshedRegisterPlugin funzione per registrarsi con PSHED.

[in, out] ErrorSource

Puntatore a una struttura WHEA_ERROR_SOURCE_DESCRIPTOR che rappresenta una particolare origine di errore implementata dalla piattaforma hardware.

Valore restituito

Un plug-in PSHED GetErrorSourceInfo funzione di callback 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.

Osservazioni

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

Il kernel di Windows chiama il PSHED per ottenere dettagli aggiuntivi su una particolare origine 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 è 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 il plug-in PSHED GetErrorSourceInfo funzione di callback in modo che il plug-in PSHED possa fornire ulteriori dettagli sull'origine degli errori. La GetErrorSourceInfo funzione di callback aggiorna il contenuto della struttura del descrittore di origine degli errori in modo che rappresenti in modo accurato l'origine degli errori implementata dalla piattaforma hardware.