PSHED_PI_DISABLE_ERROR_SOURCE funzione di callback (ntddk.h)

Articolo
02/26/2024

La funzione di callback DisableErrorSource di PSHED disabilita un'origine di errore.

Sintassi

PSHED_PI_DISABLE_ERROR_SOURCE PshedPiDisableErrorSource;

NTSTATUS PshedPiDisableErrorSource(
  [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 disabilitata.

Valore restituito

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

Codice restituito	Descrizione
STATUS_SUCCESS	L'origine degli errori è stata disabilitata correttamente.
STATUS_NOT_SUPPORTED	Il plug-in PSHED non supporta la disabilitazione 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 disabilitare un'origine di errore in risposta a una richiesta di disabilitazione dell'origine 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 DisableErrorSource del plug-in PSHED per consentire al plug-in PSHED di disabilitare l'origine errore. Se la funzione di callback DisableErrorSource restituisce STATUS_NOT_SUPPORTED, PSHED disabilita l'origine degli errori. In caso contrario, PSHED restituirà il valore restituito restituito dalla funzione di callback DisableErrorSource .

Se il plug-in PSHED disabilita 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 DisableErrorSource del plug-in PSHED restituisce. La funzione di callback DisableErrorSource di PSHED non deve modificare il descrittore dell'origine degli errori.