PSHED_PI_ENABLE_ERROR_SOURCE funzione di callback (ntddk.h)

Articolo
02/07/2025

Un plug-in PSHED EnableErrorSource funzione di callback abilita un'origine degli errori.

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 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 abilitata.

Valore restituito

Un plug-in PSHED EnableErrorSource funzione di callback 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 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 PshedFAErrorSourceControlnel 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 abilitazione 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 EnableErrorSource funzione di callback per consentire al plug-in PSHED di abilitare l'origine degli errori. Se la EnableErrorSource funzione di callback restituisce STATUS_NOT_SUPPORTED, PSHED abiliterà l'origine dell'errore. In caso contrario, PSHED restituirà solo il valore restituito dalla EnableErrorSource funzione di callback.

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