PSHED_PI_WRITE_ERROR_RECORD Rückruffunktion (ntddk.h)

Artikel
02/26/2024

Die WriteErrorRecord-Rückruffunktion eines PSHED-Plug-Ins schreibt einen Fehlerdatensatz in den persistenten Datenspeicher des Systems.

Syntax

PSHED_PI_WRITE_ERROR_RECORD PshedPiWriteErrorRecord;

NTSTATUS PshedPiWriteErrorRecord(
  [in, out, optional] PVOID PluginContext,
  [in]                ULONG Flags,
  [in]                ULONG RecordLength,
  [in]                PWHEA_ERROR_RECORD ErrorRecord
)
{...}

Parameter

[in, out, optional] PluginContext

Ein Zeiger auf den Kontextbereich, der im Kontextelement der WHEA_PSHED_PLUGIN_REGISTRATION_PACKET-Struktur angegeben wurde, als das PSHED-Plug-In die PshedRegisterPlugin-Funktion aufgerufen hat, um sich bei der PSHED zu registrieren.

[in] Flags

Eine bitweise OR'ed-Kombination von Flags, die sich auf den Schreibvorgang auswirken. Ein mögliches Flag ist:

WHEA_WRITE_FLAG_DUMMY

Der Schreibvorgang ist ein Dummyschreibvorgang. Es dürfen keine Daten in den persistenten Datenspeicher des Systems geschrieben werden.

[in] RecordLength

Die Größe des Fehlerdatensatzes in Byte, auf den der ErrorRecord-Parameter verweist.

[in] ErrorRecord

Ein Zeiger auf eine WHEA_ERROR_RECORD-Struktur , die den Fehlerdatensatz beschreibt, der in den persistenten Datenspeicher des Systems geschrieben wird.

Rückgabewert

Die WriteErrorRecord-Rückruffunktion eines PSHED-Plug-Ins gibt einen der folgenden NTSTATUS-Codes zurück:

Rückgabecode	Beschreibung
STATUS_SUCCESS	Der Fehlerdatensatz wurde erfolgreich in den persistenten Datenspeicher des Systems geschrieben.
STATUS_UNSUCCESSFUL	Ein Fehler ist aufgetreten.

Hinweise

Ein PSHED-Plug-In, das an der Persistenz des Fehlerdatensatzes beteiligt ist, legt die Rückruffunktionen Callbacks.WriteErrorRecord, Callbacks.ReadErrorRecord und Callbacks.ClearErrorRecord der WHEA_PSHED_PLUGIN_REGISTRATION_PACKET-Struktur so fest, dass sie auf die Rückruffunktionen WriteErrorRecord, ReadErrorRecord und ClearErrorRecord verweisen, wenn das Plug-In die PshedRegisterPlugin-Funktion aufruft, um sich bei PSHED zu registrieren. Das PSHED-Plug-In muss auch das PshedFAErrorRecordPersistence-Flag im FunctionalAreaMask-Member der WHEA_PSHED_PLUGIN_REGISTRATION_PACKET-Struktur festlegen.

Der Windows-Kernel ruft den PSHED auf, um einen Fehlerdatensatz in den persistenten Datenspeicher des Systems zu schreiben, wenn eine schwerwiegende oder anderweitig nicht behebbare Fehlerbedingung vorliegt, sodass der Fehlerdatensatz während des Neustarts des Systems beibehalten wird. Wenn ein PSHED-Plug-In registriert wird, um an der Persistenz des Fehlerdatensatzes teilzunehmen, ruft das PSHED-Plug-In die WriteErrorRecord-Rückruffunktion des PSHED-Plug-Ins auf, um den Schreibvorgang auszuführen. Der Mechanismus, der zum Schreiben des Fehlerdatensatzes in den persistenten Datenspeicher des Systems verwendet wird, ist plattformspezifisch.