PSHED_PI_CLEAR_ERROR_STATUS funzione di callback (ntddk.h)

Articolo
02/07/2025

Un plug-in PSHED ClearErrorStatus funzione di callback cancella eventuali 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 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 che ha segnalato l'errore hardware.

[in] BufferLength

Dimensione, 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

Un plug-in PSHED ClearErrorStatus funzione di callback restituisce uno dei codici NTSTATUS seguenti:

Codice restituito	Descrizione
STATUS_SUCCESS	I registri di stato degli errori specifici della piattaforma per la condizione di errore hardware corretta sono stati cancellati correttamente.
STATUS_NOT_SUPPORTED	Il plug-in PSHED non supporta l'origine degli errori specificata.
STATUS_UNSUCCESSFUL	Si è verificato un errore.

Osservazioni

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

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