Функция 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)
Библиотека NtosKrnl.lib
DLL NtosKrnl.exe
IRQL Любой уровень

См. также раздел

KAFFINITY

KeQueryActiveProcessors