PSHED_PI_GET_ERROR_SOURCE_INFO回呼函式 (ntddk.h)

發行項
03/05/2024

PSHED 外掛程式的 GetErrorSourceInfo 回呼函式會傳回錯誤來源描述元結構，代表硬體平臺所實作的特定錯誤來源。

語法

PSHED_PI_GET_ERROR_SOURCE_INFO PshedPiGetErrorSourceInfo;

NTSTATUS PshedPiGetErrorSourceInfo(
  [in, out, optional] PVOID PluginContext,
  [in, out]           PWHEA_ERROR_SOURCE_DESCRIPTOR ErrorSource
)
{...}

參數

[in, out, optional] PluginContext

當 PSHED 外掛程式呼叫 PshedRegisterPlugin 函式以向 PSHED 註冊本身時，在WHEA_PSHED_PLUGIN_REGISTRATION_PACKET 結構的內容成員中指定的內容區域指標。

[in, out] ErrorSource

WHEA_ERROR_SOURCE_DESCRIPTOR 結構的指標，表示硬體平臺所實作的特定錯誤來源。

傳回值

PSHED 外掛程式的 GetErrorSourceInfo 回呼函式會傳回下列其中一個 NTSTATUS 程式代碼：

傳回碼	Description
STATUS_SUCCESS	錯誤來源資訊已成功更新。
STATUS_UNSUCCESSFUL	發生錯誤。

備註

參與錯誤來源探索的 PSHED 外掛程式會設定 Callbacks.GetAllErrorSources 成員，並選擇性地設定WHEA_PSHED_PLUGIN_REGISTRATION_PACKET 結構的 Callbacks.GetErrorSourceInfo 成員，以指向其 GetAllErrorSources 和 GetErrorSourceInfo 回呼函式，當外掛程式呼叫 PshedRegisterPlugin 函式以向 PSHED 註冊本身。 PSHED 外掛程式也必須在 WHEA_PSHED_PLUGIN_REGISTRATION_PACKET 結構的 FunctionalAreaMask 成員中設定 PshedFADiscovery 旗標。

Windows 核心會呼叫 PSHED，以取得特定錯誤來源的其他詳細數據。當總線驅動程式將新的錯誤來源新增至系統時，就會發生這種情況。例如，當 PCI 驅動程式發現能夠報告 PCIe 錯誤的 PCI Express (PCIe) 裝置時，它會向操作系統報告錯誤來源。

如果 PSHED 外掛程式已註冊以參與錯誤來源探索，而且它已實作 GetErrorSourceInfo 回呼函式，在 PSHED 更新錯誤來源描述元結構之後，PSHED 會使用其收集到錯誤來源的資訊來呼叫 PSHED 外掛程式的 GetErrorSourceInfo 回呼函式，讓 PSHED 外掛程式可以提供錯誤來源的其他詳細數據。 GetErrorSourceInfo 回呼函式會更新錯誤來源描述元結構的內容，使其在硬體平台實作時正確代表錯誤來源。