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) |