PSHED_PI_GET_INJECTION_CAPABILITIES回呼函式 (ntddk.h)

發行項
02/26/2024

PSHED 外掛程式的 GetInjectionCapabilities 回呼函式會傳回錯誤插入功能聯集，描述可插入至硬體平台的硬體錯誤類型。

語法

PSHED_PI_GET_INJECTION_CAPABILITIES PshedPiGetInjectionCapabilities;

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

參數

[in, out, optional] PluginContext

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

[out] Capabilities

WHEA_ERROR_INJECTION_CAPABILITIES等位的指標。此等位會接收數據，描述可插入硬體平台的硬體錯誤類型。

傳回值

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

傳回碼	Description
STATUS_SUCCESS	描述可插入硬體平臺之硬體錯誤類型的數據，已成功在 Capabilities 參數所指向的WHEA_ERROR_INJECTION_CAPABILITIES聯集中傳回。
STATUS_UNSUCCESSFUL	發生錯誤。

備註

參與錯誤插入的 PSHED 外掛程式會設定 WHEA_PSHED_PLUGIN_REGISTRATION_PACKET 結構的 Callbacks.GetInjectionCapabilities 和 Callbacks.InjectError 成員，以在外掛程式呼叫 PshedRegisterPlugin 函式時指向其 GetInjectionCapabilities 和 InjectError 回呼函式。 PSHED 外掛程式也必須在 WHEA_PSHED_PLUGIN_REGISTRATION_PACKET 結構的 FunctionalAreaMask 成員中設定 PshedFAErrorInjection 旗標。

Windows 核心會呼叫 PSHED，以擷取可插入硬體平臺之硬體錯誤類型的相關信息，以回應 WHEA 管理應用程式查詢的錯誤插入功能。如果 PSHED 外掛程式已註冊以參與錯誤插入，PSHED 會呼叫 PSHED 外掛程式的 GetInjectionCapabilities 回呼函式，以擷取可插入硬體平臺之其他硬體錯誤類型的相關信息。