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