PSHED_PI_DISABLE_ERROR_SOURCE Rückruffunktion (ntddk.h)

Artikel
02/29/2024

Die Rückruffunktion DisableErrorSource eines PSHED-Plug-Ins deaktiviert eine Fehlerquelle.

Syntax

PSHED_PI_DISABLE_ERROR_SOURCE PshedPiDisableErrorSource;

NTSTATUS PshedPiDisableErrorSource(
  [in, out, optional] PVOID PluginContext,
  [in]                PWHEA_ERROR_SOURCE_DESCRIPTOR ErrorSource
)
{...}

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] ErrorSource

Ein Zeiger auf eine WHEA_ERROR_SOURCE_DESCRIPTOR-Struktur , die die deaktivierte Fehlerquelle beschreibt.

Rückgabewert

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

Rückgabecode	Beschreibung
STATUS_SUCCESS	Die Fehlerquelle wurde erfolgreich deaktiviert.
STATUS_NOT_SUPPORTED	Das PSHED-Plug-In unterstützt das Deaktivieren der angegebenen Fehlerquelle nicht.
STATUS_UNSUCCESSFUL	Ein Fehler ist aufgetreten.

Hinweise

Ein PSHED-Plug-In, das an der Fehlerquellensteuerung beteiligt ist, legt die Rückruffunktionen Callbacks.SetErrorSourceInfo, Callbacks.EnableErrorSource und Callbacks.DisableErrorSource der WHEA_PSHED_PLUGIN_REGISTRATION_PACKET-Struktur so fest, dass sie auf die Rückruffunktionen SetErrorSourceInfo, EnableErrorSource und DisableErrorSource verweisen, wenn das Plug-In die PshedRegisterPlugin-Funktion aufruft, um sich bei PSHED zu registrieren. Das PSHED-Plug-In muss auch das PshedFAErrorSourceControl-Flag im FunctionalAreaMask-Member der WHEA_PSHED_PLUGIN_REGISTRATION_PACKET-Struktur festlegen.

Der Windows-Kernel ruft den PSHED auf, um eine Fehlerquelle als Reaktion auf die Anforderung zur Deaktivierung einer Fehlerquelle durch eine WHEA-Verwaltungsanwendung zu deaktivieren. Wenn ein PSHED-Plug-In für die Teilnahme an der Fehlerquellensteuerung registriert ist, ruft PSHED die DisableErrorSource-Rückruffunktion des PSHED-Plug-Ins auf, um dem PSHED-Plug-In die Möglichkeit zu geben, die Fehlerquelle zu deaktivieren. Wenn die Rückruffunktion DisableErrorSource STATUS_NOT_SUPPORTED zurückgibt, deaktiviert PSHED die Fehlerquelle. Andernfalls gibt der PSHED nur den Rückgabewert zurück, der von der Rückruffunktion DisableErrorSource zurückgegeben wird.

Wenn das PSHED-Plug-In die Fehlerquelle erfolgreich deaktiviert, aktualisiert PSHED die WHEA_ERROR_SOURCE_DESCRIPTOR-Struktur im Namen des PSHED-Plug-Ins, nachdem der Aufruf der DisableErrorSource-Rückruffunktion des PSHED-Plug-Ins zurückgegeben wurde. Die Rückruffunktion DisableErrorSource eines PSHED-Plug-Ins sollte den Fehlerquellendeskriptor nicht ändern.