PSHED_PI_GET_ERROR_SOURCE_INFO Rückruffunktion (ntddk.h)

Artikel
03/01/2024

Die GetErrorSourceInfo-Rückruffunktion eines PSHED-Plug-Ins gibt eine Fehlerquellendeskriptorstruktur zurück, die eine bestimmte Fehlerquelle darstellt, die von der Hardwareplattform implementiert wird.

Syntax

PSHED_PI_GET_ERROR_SOURCE_INFO PshedPiGetErrorSourceInfo;

NTSTATUS PshedPiGetErrorSourceInfo(
  [in, out, optional] PVOID PluginContext,
  [in, out]           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, out] ErrorSource

Ein Zeiger auf eine WHEA_ERROR_SOURCE_DESCRIPTOR-Struktur , die eine bestimmte Fehlerquelle darstellt, die von der Hardwareplattform implementiert wird.

Rückgabewert

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

Rückgabecode	Beschreibung
STATUS_SUCCESS	Die Informationen zur Fehlerquelle wurden erfolgreich aktualisiert.
STATUS_UNSUCCESSFUL	Ein Fehler ist aufgetreten.

Hinweise

Ein PSHED-Plug-In, das an der Fehlerquellenermittlung beteiligt ist, legt das Element Callbacks.GetAllErrorSources und optional das Element Callbacks.GetErrorSourceInfo der WHEA_PSHED_PLUGIN_REGISTRATION_PACKET-Struktur fest, um auf die Rückruffunktionen GetAllErrorSources und GetErrorSourceInfo zu verweisen, wenn das Plug-In die PshedRegisterPlugin-Funktion aufruft, um sich bei PSHED zu registrieren. Das PSHED-Plug-In muss auch das PshedFADiscovery-Flag im FunctionalAreaMask-Element der WHEA_PSHED_PLUGIN_REGISTRATION_PACKET-Struktur festlegen.

Der Windows-Kernel ruft PSHED auf, um zusätzliche Details zu einer bestimmten Fehlerquelle zu erhalten. Dies tritt auf, wenn dem System von einem Bustreiber eine neue Fehlerquelle hinzugefügt wird. Wenn der PCI-Treiber beispielsweise ein PCI Express-Gerät (PCIe) erkennt, das PCIe-Fehler melden kann, meldet er die Fehlerquelle an das Betriebssystem.

Wenn ein PSHED-Plug-In für die Teilnahme an der Fehlerquellenermittlung registriert ist und eine GetErrorSourceInfo-Rückruffunktion implementiert wurde, ruft das PSHED-Plug-In die GetErrorSourceInfo-Rückruffunktion des PSHED-Plug-Ins auf, damit das PSHED-Plug-In zusätzliche Details zur Fehlerquelle bereitstellen kann. Die GetErrorSourceInfo-Rückruffunktion aktualisiert den Inhalt der Fehlerquellendeskriptorstruktur, sodass sie die Fehlerquelle genau darstellt, wie sie von der Hardwareplattform implementiert wird.