KeQueryGroupAffinity 函数 (ntddk.h)
KeQueryGroupAffinity 例程返回一个关联掩码,用于标识多处理器系统中指定组中的活动逻辑处理器。
语法
KAFFINITY KeQueryGroupAffinity(
[in] USHORT GroupNumber
);
参数
[in] GroupNumber
组编号。 如果多处理器系统包含 n 个 组,则组的编号从 0 到 n-1。 若要获取系统中的活动组数,请调用 KeQueryActiveGroupCount 例程。
返回值
KeQueryGroupAffinity 返回一个 KAFFINITY 值,该值标识指定组中的活动逻辑处理器。 如果 GroupNumber 参数值不是有效的组号,则例程返回零。
注解
相关的例程 KeQueryActiveProcessors 返回一个关联掩码,该掩码表示一组活动处理器,但与 KeQueryGroupAffinity 不同,此例程不接受组号作为输入参数。 在 Windows 7 及更高版本的 Windows 操作系统中, KeQueryActiveProcessors 为组 0 中的活动处理器返回关联掩码,该掩码与不支持组的早期 Windows 版本中此例程的行为兼容。 此行为可确保调用 KeQueryActiveProcessors 且不使用面向组功能的现有驱动程序将在具有两个或更多组的多处理器系统中正确运行。 但是,在 Windows 7 及更高版本的 Windows 操作系统中使用任何面向组的功能的驱动程序应调用 KeQueryGroupAffinity ,而不是 KeQueryActiveProcessors。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | 在 Windows 7 和更高版本的 Windows 中可用。 |
目标平台 | 通用 |
标头 | ntddk.h (包括 Wdm.h、Ntddk.h、Ntifs.h) |
Library | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | 任何级别 |