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 及更高版本中使用任何面向组的功能的驱动程序应调用 KeQueryGroupAffinity,而不是 KeQueryActiveProcessors

要求

要求 价值
最低支持的客户端 在 Windows 7 及更高版本的 Windows 中可用。
目标平台 普遍
标头 ntddk.h (包括 Wdm.h、Ntddk.h、Ntifs.h)
NtosKrnl.lib
DLL NtosKrnl.exe
IRQL 任何级别

另请参阅

KAFFINITY

KeQueryActiveProcessors