PSHED_PI_SET_ERROR_SOURCE_INFO funzione di callback (ntddk.h)
La funzione di callback SetErrorSourceInfo di un plug-in PSHED configura un'origine degli errori.
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 membro Context della struttura WHEA_PSHED_PLUGIN_REGISTRATION_PACKET quando il plug-in PSHED ha chiamato la funzione PshedRegisterPlugin per registrarsi con PSHED.
[in] ErrorSource
Puntatore a una struttura WHEA_ERROR_SOURCE_DESCRIPTOR che descrive l'origine degli errori configurata.
Valore restituito
La funzione di callback SetErrorSourceInfo di un plug-in PSHED 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. |
Commenti
Un plug-in PSHED che partecipa al controllo del codice sorgente degli errori imposta le funzioni di callbacks.SetErrorSourceInfo, Callbacks.EnableErrorSource e Callbacks.DisableErrorSource della struttura WHEA_PSHED_PLUGIN_REGISTRATION_PACKET in modo che puntino alle funzioni di callback SetErrorSourceInfo, EnableErrorSource e DisableErrorSource quando il plug-in chiama la funzione PshedRegisterPlugin per registrarsi con PSHED. Il plug-in PSHED deve anche impostare il flag PshedFAErrorSourceControl nel membro FunctionalAreaMask della struttura WHEA_PSHED_PLUGIN_REGISTRATION_PACKET.
Il kernel di Windows chiama 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 la funzione di callback SetErrorSourceInfo del plug-in PSHED per offrire al plug-in PSHED l'opportunità 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'altra forma di archiviazione dati non volatile disponibile per l'origine errore. La forma specifica di archiviazione dati non volatile usata da un'origine errori per l'archiviazione dei dati di configurazione dell'origine degli errori è specifica dell'implementazione. La funzione di callback SetErrorSourceInfo deve applicare i dati di configurazione all'origine degli errori in modo che le modifiche alla configurazione diventino effettive alla successiva 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 dell'errore al sistema operativo durante l'individuazione dell'origine degli errori.
Requisiti
Requisito | Valore |
---|---|
Piattaforma di destinazione | Desktop |
Intestazione | ntddk.h (include Ntddk.h) |
IRQL | IRQL = DISPATCH_LEVEL |