PSHED_PI_WRITE_ERROR_RECORD funzione di callback (ntddk.h)

Articolo
03/05/2024

Una funzione di callback WriteErrorRecord di PSHED scrive un record di errore nell'archiviazione dati persistente del sistema.

Sintassi

PSHED_PI_WRITE_ERROR_RECORD PshedPiWriteErrorRecord;

NTSTATUS PshedPiWriteErrorRecord(
  [in, out, optional] PVOID PluginContext,
  [in]                ULONG Flags,
  [in]                ULONG RecordLength,
  [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] Flags

Combinazione or'ed bit di flag che influiscono sull'operazione di scrittura. Un flag possibile è:

WHEA_WRITE_FLAG_DUMMY

L'operazione di scrittura è un'operazione di scrittura fittizia. Nessun dato deve essere scritto nell'archivio dati permanente del sistema.

[in] RecordLength

Dimensioni, in byte, del record di errore a cui punta il parametro ErrorRecord .

[in] ErrorRecord

Puntatore a una struttura WHEA_ERROR_RECORD che descrive il record di errore scritto nell'archiviazione dati persistente del sistema.

Valore restituito

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

Codice restituito	Descrizione
STATUS_SUCCESS	Il record di errore è stato scritto correttamente nell'archiviazione dati persistente del sistema.
STATUS_UNSUCCESSFUL	Si è verificato un errore.

Commenti

Un plug-in PSHED che partecipa alla persistenza dei record di errore imposta il callbacks.WriteErrorRecord, Callbacks.ReadErrorRecord e Callbacks.ClearErrorRecord della struttura WHEA_PSHED_PLUGIN_REGISTRATION_PACKET per puntare al relativo writeErrorRecord, ReadErrorRecord e ClearErrorRecord quando il plug-in chiama la funzione PshedRegisterPlugin per registrarsi con psHED. Il plug-in PSHED deve anche impostare il flag PshedFAErrorRecordPersistence nel membro FunctionalAreaMask della struttura WHEA_PSHED_PLUGIN_REGISTRATION_PACKET .

Il kernel di Windows chiama il PSHED per scrivere un record di errore nell'archiviazione dati persistente del sistema ogni volta che esiste una condizione di errore irreversibile o altrimenti non recuperabile in modo che il record di errore venga mantenuto mentre il sistema viene riavviato. Se un plug-in PSHED è registrato per partecipare alla persistenza dei record di errore, psHED chiama la funzione di callback WriteErrorRecord del plug-in PSHED per eseguire l'operazione di scrittura. Il meccanismo usato per scrivere il record di errore nell'archiviazione dati persistente del sistema è specifico della piattaforma.