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 | 任何级别 |