PSHED_PI_GET_INJECTION_CAPABILITIES Rückruffunktion (ntddk.h)

Artikel
04/21/2023

Die Rückruffunktion GetInjectionCapabilities eines PSHED-Plug-Ins gibt eine Fehlereinschleusungsfunktion zurück, die die Typen von Hardwarefehlern beschreibt, die in die Hardwareplattform eingefügt werden können.

Syntax

PSHED_PI_GET_INJECTION_CAPABILITIES PshedPiGetInjectionCapabilities;

NTSTATUS PshedPiGetInjectionCapabilities(
  [in, out, optional] PVOID PluginContext,
  [out]               PWHEA_ERROR_INJECTION_CAPABILITIES Capabilities
)
{...}

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.

[out] Capabilities

Ein Zeiger auf eine WHEA_ERROR_INJECTION_CAPABILITIES Union. Diese Union empfängt die Daten, die die Arten von Hardwarefehlern beschreiben, die in die Hardwareplattform eingefügt werden können.

Rückgabewert

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

Rückgabecode	Beschreibung
STATUS_SUCCESS	Die Daten, die die Typen von Hardwarefehlern beschreiben, die in die Hardwareplattform eingefügt werden können, wurden erfolgreich in der WHEA_ERROR_INJECTION_CAPABILITIES Union zurückgegeben, auf die der Capabilities-Parameter verweist.
STATUS_UNSUCCESSFUL	Ein Fehler ist aufgetreten.

Hinweise

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

Der Windows-Kernel ruft den PSHED auf, um Informationen über die Arten von Hardwarefehlern abzurufen, die als Reaktion auf eine Anforderung der Fehlerinjektionsfunktionen durch eine WHEA-Verwaltungsanwendung in die Hardwareplattform eingefügt werden können. Wenn ein PSHED-Plug-In für die Teilnahme an der Fehlerinjektion registriert ist, ruft PSHED die Rückruffunktion GetInjectionCapabilities des PSHED-Plug-Ins auf, um Informationen zu zusätzlichen Arten von Hardwarefehlern abzurufen, die in die Hardwareplattform eingefügt werden können.