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
如果 State 成員包含 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) |