PSHED_PI_GET_INJECTION_CAPABILITIES Rückruffunktion (ntddk.h)

Artikel
02/07/2025

Die GetInjectionCapabilities Rückruffunktion eines PSHED-Plug-Ins gibt eine Vereinigung der Fehlereinfügungsfunktionen zurück, die die Arten 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 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.

[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 GetInjectionCapabilities eines PSHED-Plug-Ins Rückruffunktion gibt einen der folgenden NTSTATUS-Codes zurück:

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

Bemerkungen

Ein PSHED-Plug-In, das an der Fehlereinfügung teilnimmt, legt die Callbacks.GetInjectionCapabilities- und Callbacks.InjectError- Member der WHEA_PSHED_PLUGIN_REGISTRATION_PACKET Struktur auf Punkt fest. zu seinen GetInjectionCapabilities und InjectError Rückruffunktionen, 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 Member der WHEA_PSHED_PLUGIN_REGISTRATION_PACKET Struktur festlegen.

Der Windows-Kernel ruft die PSHED auf, um Informationen zu den Arten von Hardwarefehlern abzurufen, die als Reaktion auf eine Untersuchung der Fehlereinfügungsfunktionen von einer WHEA-Verwaltungsanwendung in die Hardwareplattform eingefügt werden können. Wenn ein PSHED-Plug-In registriert ist, um an der Fehlereinfügung teilzunehmen, ruft PSHED das PSHED-Plug-Ins GetInjectionCapabilities Rückruffunktion auf, um Informationen zu zusätzlichen Arten von Hardwarefehlern abzurufen, die in die Hardwareplattform eingefügt werden können.