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)

另請參閱

KeGetProcessorNumberFromIndex

KeRegisterProcessorChangeCallback

PROCESSOR_NUMBER