PSHED_PI_ENABLE_ERROR_SOURCE回呼函式 (ntddk.h)

發行項
02/26/2024

PSHED 外掛程式的 EnableErrorSource 回呼函式會啟用錯誤來源。

語法

PSHED_PI_ENABLE_ERROR_SOURCE PshedPiEnableErrorSource;

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

參數

[in, out, optional] PluginContext

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

[in] ErrorSource

描述所啟用錯誤來源 之WHEA_ERROR_SOURCE_DESCRIPTOR 結構的指標。

傳回值

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

傳回碼	Description
STATUS_SUCCESS	已成功啟用錯誤來源。
STATUS_NOT_SUPPORTED	PSHED 外掛程式不支援啟用指定的錯誤來源。
STATUS_UNSUCCESSFUL	發生錯誤。

備註

參與錯誤原始檔控制的 PSHED 外掛程式會在外掛程式呼叫 PshedRegisterPlugin 函式時，設定WHEA_PSHED_PLUGIN_REGISTRATION_PACKET結構的 Callbacks.SetErrorSourceInfo、Callbacks.EnableErrorSource 和 Callbacks.DisableErrorSource 成員，以指向其 SetErrorSourceInfo、EnableErrorSource 和 DisableErrorSource 回呼函式時，外掛程式會呼叫 PshedRegisterPlugin 函式來註冊其本身。 PSHED 外掛程式也必須在 WHEA_PSHED_PLUGIN_REGISTRATION_PACKET 結構的 FunctionalAreaMask 成員中設定 PshedFAErrorSourceControl 旗標。

Windows 核心會呼叫 PSHED，以啟用錯誤來源探索期間所報告的每個錯誤來源。 Windows 核心也會呼叫 PSHED，以啟用錯誤來源，以回應 WHEA 管理應用程式發出錯誤來源啟用要求。如果 PSHED 外掛程式已註冊參與錯誤原始檔控制，PSHED 會呼叫 PSHED 外掛程式的 EnableErrorSource 回呼函式，讓 PSHED 外掛程式有機會啟用錯誤來源。如果 EnableErrorSource 回呼函式傳回STATUS_NOT_SUPPORTED，PSHED 將會啟用錯誤來源。否則，PSHED 只會傳回 EnableErrorSource 回呼函式所傳回的傳回值。

如果 PSHED 外掛程式成功啟用錯誤來源，PSHED 會在呼叫 PSHED 外掛程式的 EnableErrorSource 回呼函式傳回之後，代表 PSHED 外掛程式更新WHEA_ERROR_SOURCE_DESCRIPTOR結構。 PSHED 外掛程式的 EnableErrorSource 回呼函式不應該修改錯誤來源描述項。