PSHED_PI_CLEAR_ERROR_STATUS funzione di callback (ntddk.h)

Articolo
02/26/2024

Una funzione di callback ClearErrorStatus di PSHED cancella i registri di stato degli errori specifici della piattaforma per una condizione di errore hardware corretta.

Sintassi

PSHED_PI_CLEAR_ERROR_STATUS PshedPiClearErrorStatus;

NTSTATUS PshedPiClearErrorStatus(
  [in, out, optional] PVOID PluginContext,
  [in]                PWHEA_ERROR_SOURCE_DESCRIPTOR ErrorSource,
  [in]                ULONG BufferLength,
  [in]                PWHEA_ERROR_RECORD ErrorRecord
)
{...}

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 che ha segnalato l'errore hardware.

[in] BufferLength

Dimensioni, in byte, del buffer a cui punta il parametro ErrorRecord .

[in] ErrorRecord

Puntatore a una struttura WHEA_ERROR_RECORD che descrive un record di errore. Il record di errore descrive la condizione di errore hardware corretta per cui vengono cancellati i registri di stato degli errori specifici della piattaforma.

Valore restituito

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

Codice restituito	Descrizione
STATUS_SUCCESS	Lo stato dell'errore specifico della piattaforma registra la condizione di errore hardware corretta è stata cancellata correttamente.
STATUS_NOT_SUPPORTED	Il plug-in PSHED non supporta l'origine di errore specificata.
STATUS_UNSUCCESSFUL	Si è verificato un errore.

Commenti

Un plug-in PSHED che partecipa al recupero delle informazioni sugli errori imposta il callbacks.RetrieveErrorInfo, Callbacks.FinalizeErrorRecord e Callbacks.ClearErrorStatusdella struttura WHEA_PSHED_PLUGIN_REGISTRATION_PACKET per puntare al relativo RecuperoErrorInfo, FinalizeErrorRecord e Funzioni di callback ClearErrorStatus quando il plug-in chiama la funzione PshedRegisterPlugin per registrarsi con PSHED. Il plug-in PSHED deve anche impostare il flag PshedFAErrorInfoRetrieval nel membro FunctionalAreaMask della struttura WHEA_PSHED_PLUGIN_REGISTRATION_PACKET.

Per le condizioni di errore hardware corrette, il kernel di Windows chiama il PSHED per cancellare lo stato di errore dell'origine degli errori registrato come passaggio finale dell'elaborazione dell'errore. Se un plug-in PSHED viene registrato per partecipare al recupero delle informazioni sugli errori, PSHED chiama la funzione di callback ClearErrorStatus del plug-in PSHED in modo che il plug-in PSHED possa cancellare eventuali registri di stato degli errori specifici della piattaforma aggiuntivi.