共用方式為


KE_PROCESSOR_CHANGE_NOTIFY_CONTEXT結構 (wdm.h)

KE_PROCESSOR_CHANGE_NOTIFY_CONTEXT 結構描述當新處理器動態新增至硬體分割區時,傳遞給已註冊回呼函式的通知內容。

語法

typedef struct _KE_PROCESSOR_CHANGE_NOTIFY_CONTEXT {
  KE_PROCESSOR_CHANGE_NOTIFY_STATE State;
  ULONG                            NtNumber;
  NTSTATUS                         Status;
  PROCESSOR_NUMBER                 ProcNumber;
} KE_PROCESSOR_CHANGE_NOTIFY_CONTEXT, *PKE_PROCESSOR_CHANGE_NOTIFY_CONTEXT;

成員

State

處理器新增作業的狀態。 可能的值如下:

KeProcessorAddStartNotify

作系統即將新增處理器。 在此狀態中,接收此通知的裝置驅動程式可以配置任何每個處理器的數據結構,並執行任何其他必要工作,以準備驅動程式以在新處理器上執行。

KeProcessorAddCompleteNotify

作系統已成功新增處理器。 在此狀態中,接收此通知的裝置驅動程式可以開始在新處理器上排程線程。

KeProcessorAddFailureNotify

作系統無法新增處理器。 如果裝置驅動程式收到此通知,則當裝置驅動程式收到 KeProcessorAddStartNotify 通知時,應該釋放它為新處理器配置的任何個別處理器數據結構。

NtNumber

新處理器的處理器索引。 如需處理器索引與處理器編號之間關聯性的詳細資訊,請參閱 KeGetProcessorNumberFromIndex

Status

如果 狀態 成員包含 KeProcessorAddFailureNotify,則此成員包含錯誤狀態,指出處理器新增作業失敗的原因。

ProcNumber

新處理器的處理器編號。 這個成員是 PROCESSOR_NUMBER 結構,可指定群組編號和群組相對處理器編號。

言論

從 Windows Server 2008 開始,即可使用 KE_PROCESSOR_CHANGE_NOTIFY_CONTEXT 結構。

裝置驅動程式會藉由呼叫 KeRegisterProcessorChangeCallback 函式,以動態方式將新的處理器新增至硬體磁碟分區時,註冊以接收通知。 如需註冊此通知的詳細資訊,請參閱 註冊同步驅動程式通知

當新的處理器動態新增至硬體分割區時,作系統會呼叫每個已註冊的回呼函式兩次。 作系統會第一次使用 KeProcessorAddStartNotify 狀態呼叫每個已註冊的回呼函式,第二次使用 KeProcessorAddCompleteNotify 狀態或 KeProcessorAddFailureNotify 狀態。

接收這些通知的裝置驅動程式回呼函式不得修改 KE_PROCESSOR_CHANGE_NOTIFY_CONTEXT 結構的內容。

要求

要求 價值
最低支援的用戶端 從 Windows Server 2008 開始支援。
標頭 wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h)

另請參閱

KeGetProcessorNumberFromIndex

KeRegisterProcessorChangeCallback

PROCESSOR_NUMBER