PSHED_PI_GET_ERROR_SOURCE_INFO Rückruffunktion (ntddk.h)

Artikel
02/07/2025

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

Rückgabecode	Beschreibung
STATUS_SUCCESS	Die Fehlerquelleninformationen wurden erfolgreich aktualisiert.
STATUS_UNSUCCESSFUL	Fehler.

Bemerkungen

Ein PSHED-Plug-In, das an der Fehlerquellenermittlung teilnimmt, legt die Callbacks.GetAllErrorSources Member und, optional zeigt das Callbacks.GetErrorSourceInfo Member der WHEA_PSHED_PLUGIN_REGISTRATION_PACKET Struktur auf seine GetAllErrorSources und GetErrorSourceInfo Rückruffunktionen, wenn das Plug-In die PshedRegisterPlugin-Funktion aufruft, um sich bei der PSHED-Funktion zu registrieren. Das PSHED-Plug-In muss auch das PshedFADiscovery- Flag im FunctionalAreaMask Member 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 eine neue Fehlerquelle von einem Bustreiber hinzugefügt wird. Wenn der PCI-Treiber beispielsweise ein PCI Express(PCIe)-Gerät erkennt, das PCIe-Fehler melden kann, meldet er die Fehlerquelle an das Betriebssystem.

Wenn ein PSHED-Plug-In registriert ist, um an der Fehlerquellenermittlung teilzunehmen und eine GetErrorSourceInfo Rückruffunktion implementiert hat, nachdem die PSHED die Fehlerquellendeskriptorstruktur mit den Informationen aktualisiert hat, die sie über die Fehlerquelle gesammelt hat, ruft das PSHED-Plug-In die GetErrorSourceInfo Rückruffunktion auf, damit das PSHED-Plug-In zusätzliche Details zur Fehlerquelle bereitstellen kann. Die GetErrorSourceInfo Rückruffunktion aktualisiert den Inhalt der Fehlerquellenbeschreibungsstruktur, sodass sie die Fehlerquelle genau darstellt, wie sie von der Hardwareplattform implementiert wird.