PSHED_PI_ENABLE_ERROR_SOURCE Rückruffunktion (ntddk.h)

Artikel
02/07/2025

Die EnableErrorSource Rückruffunktion eines PSHED-Plug-Ins ermöglicht eine Fehlerquelle.

Syntax

PSHED_PI_ENABLE_ERROR_SOURCE PshedPiEnableErrorSource;

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

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 aktivierte Fehlerquelle beschreibt.

Rückgabewert

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

Rückgabecode	Beschreibung
STATUS_SUCCESS	Die Fehlerquelle wurde erfolgreich aktiviert.
STATUS_NOT_SUPPORTED	Das PSHED-Plug-In unterstützt das Aktivieren der angegebenen Fehlerquelle nicht.
STATUS_UNSUCCESSFUL	Fehler.

Bemerkungen

Ein PSHED-Plug-In, das an der Fehlerquellensteuerung teilnimmt, legt die Callbacks.SetErrorSourceInfo, Callbacks.EnableErrorSourceund Callbacks.DisableErrorSource Member der WHEA_PSHED_PLUGIN_REGISTRATION_PACKET Struktur auf zeigen Sie auf die SetErrorSourceInfo-, EnableErrorSource-und DisableErrorSource- Rückruffunktionen, 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 die PSHED auf, um jede der Fehlerquellen zu aktivieren, die während der Fehlerquellenermittlung gemeldet wurden. Der Windows-Kernel ruft auch die PSHED auf, um eine Fehlerquelle als Reaktion auf eine Fehlerquelle zu aktivieren, die von einer WHEA-Verwaltungsanwendung angefordert wird. Wenn ein PSHED-Plug-In für die Teilnahme an der Fehlerquelle registriert ist, ruft PSHED das EnableErrorSource Callback-Funktion des PSHED-Plug-Ins auf, um dem PSHED-Plug-In die Möglichkeit zu geben, die Fehlerquelle zu aktivieren. Wenn die EnableErrorSource Rückruffunktion STATUS_NOT_SUPPORTED zurückgibt, aktiviert die PSHED die Fehlerquelle. Andernfalls gibt PSHED nur den Rückgabewert zurück, der von der EnableErrorSource- Rückruffunktion zurückgegeben wird.

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