Функция 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 | Любой уровень |