PSHED_PI_DISABLE_ERROR_SOURCE回呼函式 (ntddk.h)
PSHED 外掛程式的 DisableErrorSource 回呼函式會停用錯誤來源。
語法
PSHED_PI_DISABLE_ERROR_SOURCE PshedPiDisableErrorSource;
NTSTATUS PshedPiDisableErrorSource(
[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 外掛程式的 DisableErrorSource 回呼函式會傳回下列其中一個 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 回呼函式。 PSHED 外掛程式也必須在 WHEA_PSHED_PLUGIN_REGISTRATION_PACKET 結構的 FunctionalAreaMask 成員中設定 PshedFAErrorSourceControl 旗標。
Windows 核心會呼叫 PSHED,以停用錯誤來源,以回應 WHEA 管理應用程式的錯誤來源停用要求。 如果 PSHED 外掛程式已註冊參與錯誤原始檔控制,PSHED 會呼叫 PSHED 外掛程式的 DisableErrorSource 回呼函式,讓 PSHED 外掛程式有機會停用錯誤來源。 如果 DisableErrorSource 回呼函式傳回STATUS_NOT_SUPPORTED,PSHED 將會停用錯誤來源。 否則,PSHED 只會傳回 DisableErrorSource 回呼函式所傳回的傳回值。
如果 PSHED 外掛程式成功停用錯誤來源,PSHED 將會在呼叫 PSHED 外掛程式的 DisableErrorSource 回呼函式之後,代表 PSHED 外掛程式更新WHEA_ERROR_SOURCE_DESCRIPTOR結構。 PSHED 外掛程式的 DisableErrorSource 回呼函式不應修改錯誤來源描述元。
規格需求
需求 | 值 |
---|---|
目標平台 | 桌面 |
標頭 | ntddk.h (包含 Ntddk.h) |
IRQL | IRQL = DISPATCH_LEVEL |