PSHED_PI_CLEAR_ERROR_STATUS Rückruffunktion (ntddk.h)

Artikel
02/29/2024

Die ClearErrorStatus-Rückruffunktion eines PSHED-Plug-Ins löscht alle plattformspezifischen Fehler status registriert sich 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 Kontextelement der WHEA_PSHED_PLUGIN_REGISTRATION_PACKET-Struktur angegeben wurde, als das PSHED-Plug-In die PshedRegisterPlugin-Funktion aufgerufen hat, um sich beim PSHED 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 die 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 der plattformspezifische Fehler status Register gelöscht wird.

Rückgabewert

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

Rückgabecode	Beschreibung
STATUS_SUCCESS	Der plattformspezifische Fehler status Registern für die korrigierte Hardwarefehlerbedingung wurde erfolgreich gelöscht.
STATUS_NOT_SUPPORTED	Das PSHED-Plug-In unterstützt die angegebene Fehlerquelle nicht.
STATUS_UNSUCCESSFUL	Ein Fehler ist aufgetreten.

Hinweise

Ein PSHED-Plug-In, das am Abrufen von Fehlerinformationen beteiligt ist, legt die Rückruffunktionen Callbacks.RetrieveErrorInfo, Callbacks.FinalizeErrorRecord und Callbacks.ClearErrorStatus der WHEA_PSHED_PLUGIN_REGISTRATION_PACKET-Struktur so fest, dass sie auf die Rückruffunktionen RetrieveErrorInfo, FinalizeErrorRecord und ClearErrorStatus verweisen, wenn das Plug-In die PshedRegisterPlugin-Funktion aufruft, um sich beim PSHED zu registrieren. Das PSHED-Plug-In muss auch das PshedFAErrorInfoRetrieval-Flag im FunctionalAreaMask-Element der WHEA_PSHED_PLUGIN_REGISTRATION_PACKET-Struktur festlegen.

Bei korrigierten Hardwarefehlerbedingungen ruft der Windows-Kernel den PSHED auf, um den Fehler der Fehlerquelle zu löschen, status als letzten Schritt der Verarbeitung des Fehlers registriert wird. Wenn ein PSHED-Plug-In für die Teilnahme am Abrufen von Fehlerinformationen registriert ist, ruft PSHED die ClearErrorStatus-Rückruffunktion des PSHED-Plug-Ins auf, damit das PSHED-Plug-In alle weiteren plattformspezifischen Fehler status Register löschen kann.