Функция KeQueryGroupAffinity (wdm.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. |
| целевая платформа | Всеобщий |
| заголовка | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| библиотеки | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | Любой уровень |