wdm.h) (KE_PROCESSOR_CHANGE_NOTIFY_CONTEXT 结构

  • 项目

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 结构，用于指定组编号和组相对处理器编号。

注解

KE_PROCESSOR_CHANGE_NOTIFY_CONTEXT 结构从 Windows Server 2008 开始可用。

通过调用 KeRegisterProcessorChangeCallback 函数将新处理器动态添加到硬件分区时，设备驱动程序会进行注册以接收通知。 有关注册此通知的详细信息，请参阅 注册同步驱动程序通知。

将新处理器动态添加到硬件分区时，操作系统会调用每个已注册的回调函数两次。 操作系统首次使用 KeProcessorAddStartNotify 状态调用每个已注册的回调函数，第二次调用 具有 KeProcessorAddCompleteNotify 状态或 KeProcessorAddFailureNotify 状态的回调函数。

接收这些通知的设备驱动程序的回调函数不得修改 KE_PROCESSOR_CHANGE_NOTIFY_CONTEXT 结构的内容。

要求

要求 值
最低受支持的客户端 从 Windows Server 2008 开始受支持。
标头 wdm.h（包括 Wdm.h、Ntddk.h、Ntifs.h）

另请参阅

KeGetProcessorNumberFromIndex

KeRegisterProcessorChangeCallback

PROCESSOR_NUMBER