KeQueryActiveProcessorCount 函数 (ntddk.h)

KeQueryActiveProcessorCount 例程返回当前处于活动状态的处理器数。

语法

ULONG KeQueryActiveProcessorCount(
  [out, optional] PKAFFINITY ActiveProcessors
);

参数

[out, optional] ActiveProcessors

指向 KAFFINITY 类型的变量的指针,例程在该变量中写入表示当前活动处理器集的位掩码。 在热添加环境中,此掩码可能会在运行时更改。 此参数是可选的,如果调用方不需要活动处理器的掩码,则可以指定为 NULL

返回值

KeQueryActiveProcessorCount 返回当前处于活动状态的处理器数。

注解

设备驱动程序调用 KeQueryActiveProcessorCount 例程来检索当前处于活动状态的处理器数。 为 Windows Vista 和更高版本的 Windows 操作系统生成的设备驱动程序不应为此使用 KeNumberProcessors 内核变量。

调用方不能假定 KeQueryActiveProcessorCount 例程连续将处理器映射到返回的 KAFFINITY 值中的位,或者每次调用该例程时都将返回相同的位掩码。

调用方还必须知道 ,KeQueryActiveProcessorCount 返回的值可以在支持热添加 CPU 功能的 Windows 版本中在运行时发生更改。

如有必要,请通过调用 KeRegisterProcessorChangeCallback 例程注册处理器数更改通知。

若要仅查询关联掩码而不获取活动处理器的数量,请使用 KeQueryActiveProcessors

Windows 7 及更高版本的 Windows 支持处理器组。 旨在处理处理器组相关信息的驱动程序应使用 KeQueryActiveProcessorCountEx 例程,该例程指定处理器组,而不是 KeQueryActiveProcessorCount,后者不指定。 但是,Windows 7 及更高版本中 KeQueryActiveProcessorCount 的实现为不支持处理器组的早期版本 Windows 编写的驱动程序提供了兼容性。 在此实现中, KeQueryActiveProcessorCount 返回组 0 中的活动逻辑处理器数,并将关联掩码写入 *ActiveProcessors ,以指定组 0 中的活动逻辑处理器集。

要求

要求
最低受支持的客户端 在 Windows Vista 和更高版本的 Windows 中可用。
目标平台 通用
标头 ntddk.h (包括 Wdm.h、Ntddk.h)
Library NtosKrnl.lib
DLL NtosKrnl.exe
IRQL 任何级别

另请参阅

KeQueryActiveProcessorCountEx

KeQueryActiveProcessors

KeRegisterProcessorChangeCallback