PSHED_PI_ENABLE_ERROR_SOURCE funzione di callback (ntddk.h)

Articolo
04/21/2023

La funzione di callback EnableErrorSource di PSHED consente un'origine di errore.

Sintassi

PSHED_PI_ENABLE_ERROR_SOURCE PshedPiEnableErrorSource;

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

Parametri

[in, out, optional] PluginContext

Puntatore all'area di contesto specificata nel membro Contesto 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 abilitata.

Valore restituito

Una funzione di callback enableErrorSource di PSHED restituisce uno dei codici NTSTATUS seguenti:

Codice restituito	Descrizione
STATUS_SUCCESS	L'origine dell'errore è stata abilitata correttamente.
STATUS_NOT_SUPPORTED	Il plug-in PSHED non supporta l'abilitazione dell'origine di 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 callbacks.SetErrorSourceInfo, Callbacks.EnableErrorSource e Callbacks.DisableErrorSourcedella struttura WHEA_PSHED_PLUGIN_REGISTRATION_PACKET per puntare alle funzioni 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 il PSHED per abilitare ognuna delle origini di errore segnalate durante l'individuazione dell'origine degli errori. Il kernel di Windows chiama anche PSHED per abilitare un'origine di errore in risposta a una richiesta di attivazione 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, il PSHED chiama la funzione di callback enableErrorSource del plug-in PSHED per consentire al plug-in PSHED di abilitare l'origine degli errori. Se la funzione di callback EnableErrorSource restituisce STATUS_NOT_SUPPORTED, PSHED abiliterà l'origine degli errori. In caso contrario, PSHED restituirà il valore restituito restituito dalla funzione di callback EnableErrorSource .

Se il plug-in PSHED abilita correttamente l'origine degli errori, PSHED aggiornerà la struttura di WHEA_ERROR_SOURCE_DESCRIPTOR per conto del plug-in PSHED dopo la chiamata alla funzione di callback enableErrorSource di PSHED. La funzione di callback EnableErrorSource di PSHED non deve modificare il descrittore dell'origine degli errori.