PSHED_PI_CLEAR_ERROR_STATUS Rückruffunktion (ntddk.h)

Artikel
02/07/2025

Die ClearErrorStatus Rückruffunktion eines PSHED-Plug-Ins löscht alle plattformspezifischen Fehlerstatusregister für eine korrigierte Hardwarefehlerbedingung.

Syntax

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
)
{...}

Parameter

[in, out, optional] PluginContext

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

[in] ErrorSource

Ein Zeiger auf eine WHEA_ERROR_SOURCE_DESCRIPTOR-Struktur, die die Fehlerquelle beschreibt, die den Hardwarefehler gemeldet hat.

[in] BufferLength

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

[in] ErrorRecord

Ein Zeiger auf eine WHEA_ERROR_RECORD Struktur, die einen Fehlerdatensatz beschreibt. Der Fehlerdatensatz beschreibt die korrigierte Hardwarefehlerbedingung, für die die plattformspezifischen Fehlerstatusregister gelöscht werden.

Rückgabewert

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

Rückgabecode	Beschreibung
STATUS_SUCCESS	Die plattformspezifischen Fehlerstatusregister für die korrigierte Hardwarefehlerbedingung wurden erfolgreich gelöscht.
STATUS_NOT_SUPPORTED	Das PSHED-Plug-In unterstützt die angegebene Fehlerquelle nicht.
STATUS_UNSUCCESSFUL	Fehler.

Bemerkungen

Ein PSHED-Plug-In, das am Abrufen von Fehlerinformationen teilnimmt, legt die Callbacks.RetrieveErrorInfo, Callbacks.FinalizeErrorRecordund Callbacks.ClearErrorStatus Member der WHEA_PSHED_PLUGIN_REGISTRATION_PACKET Struktur fest zeigen Sie auf die RetrieveErrorInfo-, FinalizeErrorRecordund ClearErrorStatus Rückruffunktionen, wenn das Plug-In die PshedRegisterPlugin--Funktion aufruft, um sich bei der PSHED-Funktion zu registrieren. Das PSHED-Plug-In muss auch das PshedFAErrorInfoRetrieval Flag im FunctionalAreaMask Member der WHEA_PSHED_PLUGIN_REGISTRATION_PACKET Struktur festlegen.

Bei korrigierten Hardwarefehlerbedingungen ruft der Windows-Kernel PSHED auf, um den Fehlerstatus der Fehlerquelle als letzten Schritt der Fehlerverarbeitung zu löschen. Wenn ein PSHED-Plug-In registriert ist, um an dem Abruf von Fehlerinformationen teilzunehmen, ruft PSHED das ClearErrorStatus Rückruffunktion auf, sodass das PSHED-Plug-In alle zusätzlichen plattformspezifischen Fehlerstatusregister löschen kann.