PSHED_PI_SET_ERROR_SOURCE_INFO Rückruffunktion (ntddk.h)

Artikel
02/26/2024

Die SetErrorSourceInfo-Rückruffunktion eines PSHED-Plug-Ins konfiguriert eine Fehlerquelle.

Syntax

PSHED_PI_SET_ERROR_SOURCE_INFO PshedPiSetErrorSourceInfo;

NTSTATUS PshedPiSetErrorSourceInfo(
  [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 beim PSHED zu registrieren.

[in] ErrorSource

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

Rückgabewert

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

Rückgabecode	Beschreibung
STATUS_SUCCESS	Die Fehlerquelle wurde erfolgreich konfiguriert.
STATUS_NOT_SUPPORTED	Das PSHED-Plug-In unterstützt die Konfiguration 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.DisableErrorSourceSource 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 beim 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 eine Fehlerquellenkonfigurationsanforderung einer WHEA-Verwaltungsanwendung zu konfigurieren. Wenn ein PSHED-Plug-In für die Teilnahme an der Fehlerquellensteuerung registriert ist, ruft PSHED die SetErrorSourceInfo-Rückruffunktion des PSHED-Plug-Ins auf, um dem PSHED-Plug-In die Möglichkeit zu geben, den Konfigurationsvorgang für die Fehlerquelle auszuführen. Die Konfigurationsdaten der Fehlerquelle sind in der WHEA_ERROR_SOURCE_DESCRIPTOR-Struktur enthalten, auf die der ErrorSource-Parameter verweist.

Wenn das PSHED-Plug-In die Konfiguration der angegebenen Fehlerquelle nicht unterstützt, gibt die Rückruffunktion SetErrorSourceInfo STATUS_NOT_SUPPORTED zurück. In dieser Situation führt der PSHED den angeforderten Fehlerquellenkonfigurationsvorgang aus.

Wenn das PSHED-Plug-In die Konfiguration der angegebenen Fehlerquelle unterstützt, sollte die SetErrorSourceInfo-Rückruffunktion die Konfigurationsdaten der Fehlerquelle in der Registrierung, in den BIOS-Tabellen des Systems oder in einer anderen Form von nichtvolatilem Datenspeicher speichern, der für die Fehlerquelle verfügbar ist. Die spezifische Form des nichtflüchtigen Datenspeichers, der von einer Fehlerquelle zum Speichern der Konfigurationsdaten der Fehlerquelle verwendet wird, ist implementierungsspezifisch. Die SetErrorSourceInfo-Rückruffunktion sollte die Konfigurationsdaten so auf die Fehlerquelle anwenden, dass die Konfigurationsänderungen beim nächsten Neustart des Systems wirksam werden. Wenn das System neu gestartet wird, sollte das PSHED-Plug-In während der Fehlerquellenermittlung die neuen Fehlerquellenkonfigurationsdaten für die Fehlerquelle an das Betriebssystem melden.