PSHED_PI_SET_ERROR_SOURCE_INFO funzione di callback (ntddk.h)

Articolo
02/07/2025

Un plug-in PSHED SetErrorSourceInfo funzione di callback configura un'origine di errore.

Sintassi

PSHED_PI_SET_ERROR_SOURCE_INFO PshedPiSetErrorSourceInfo;

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

Puntatore a una struttura WHEA_ERROR_SOURCE_DESCRIPTOR che descrive l'origine dell'errore configurata.

Valore restituito

Un plug-in PSHED SetErrorSourceInfo funzione di callback restituisce uno dei codici NTSTATUS seguenti:

Codice restituito	Descrizione
STATUS_SUCCESS	L'origine dell'errore è stata configurata correttamente.
STATUS_NOT_SUPPORTED	Il plug-in PSHED non supporta la configurazione dell'origine errore specificata.
STATUS_UNSUCCESSFUL	Si è verificato un errore.

Osservazioni

Un plug-in PSHED che partecipa al controllo del codice sorgente degli errori imposta il Callbacks.SetErrorSourceInfo, Callbacks.EnableErrorSourcee i membri Callbacks.DisableErrorSource della struttura WHEA_PSHED_PLUGIN_REGISTRATION_PACKET a cui puntare il relativo SetErrorSourceInfo, EnableErrorSourcee DisableErrorSource funzioni di callback quando il plug-in chiama la funzione PshedRegisterPlugin per registrarsi con PSHED. Il plug-in PSHED deve anche impostare il flag di PshedFAErrorSourceControl membro della struttura WHEA_PSHED_PLUGIN_REGISTRATION_PACKET functionalAreaMask.

Il kernel di Windows chiama il PSHED per configurare un'origine degli errori in risposta a una richiesta di configurazione dell'origine degli errori da parte di un'applicazione di gestione WHEA. Se un plug-in PSHED è registrato per partecipare al controllo del codice sorgente degli errori, PSHED chiama il plug-in PSHED SetErrorSourceInfo funzione di callback per consentire al plug-in PSHED di eseguire l'operazione di configurazione dell'origine degli errori. I dati di configurazione dell'origine degli errori sono inclusi nella struttura WHEA_ERROR_SOURCE_DESCRIPTOR a cui punta il parametro ErrorSource.

Se il plug-in PSHED non supporta la configurazione dell'origine errore specificata, la funzione di callback SetErrorSourceInfo restituisce STATUS_NOT_SUPPORTED. In questo caso, PSHED esegue l'operazione di configurazione dell'origine degli errori richiesta.

Se il plug-in PSHED supporta la configurazione dell'origine errore specificata, la funzione di callback SetErrorSourceInfo deve salvare i dati di configurazione dell'origine degli errori nel Registro di sistema, nelle tabelle BIOS del sistema o in un altro formato di archiviazione dei dati non volatile disponibile per l'origine degli errori. La forma specifica di archiviazione dei dati non volatile usata da un'origine degli errori per l'archiviazione dei dati di configurazione dell'origine degli errori è specifica dell'implementazione. Il SetErrorSourceInfo funzione di callback deve applicare i dati di configurazione all'origine degli errori in modo che le modifiche alla configurazione diventino effettive al successivo riavvio del sistema. Quando il sistema viene riavviato, il plug-in PSHED deve segnalare i nuovi dati di configurazione dell'origine degli errori per l'origine degli errori al sistema operativo durante l'individuazione dell'origine degli errori.