Функция KeQueryActiveGroupCount (wdm.h)
Подпрограмма KeQueryActiveGroupCount возвращает количество активных групп обработчиков в многопроцессорной системе.
Синтаксис
USHORT KeQueryActiveGroupCount();
Возвращаемое значение
KeQueryActiveGroupCount возвращает количество активных групп.
Замечания
Группа обработчиков активна, если она содержит один или несколько активных логических процессоров.
Активный логический процессор — это логический процессор, запущенный и добавленный в систему с несколькими процессорами Windows. Термин активного процессора применяется к процессору, который доступен для выполнения обработки, независимо от того, выполняется ли обработчик в настоящее время выполняет обработку или находится в состоянии простоя. В некоторых системах число активных процессоров может оставаться неизменным от запуска системы до завершения работы. В других системах Windows может динамически добавлять активные процессоры во время работы системы. Windows никогда не удаляет активные процессоры из системы.
Таким образом, число активных процессоров в многопроцессорной системе может увеличиваться между запуском системы и завершением работы, но это число никогда не уменьшается. Аналогичным образом, число активных групп в системе может увеличиться, если процессор динамически добавляется в неактивную группу во время работы системы. Количество активных групп никогда не уменьшается.
В отличие от этого, значение, возвращаемое KeQueryMaximumGroupCount остается постоянным во время выполнения. Это значение — максимальное количество групп, которые может иметь система.
Вызовите подпрограмму KeQueryActiveProcessorCountEx, чтобы определить количество активных логических процессоров в определенной группе.
Windows 7 — это первая версия Windows для поддержки групп процессоров. В Windows 7 только 64-разрядные версии Windows поддерживают несколько групп; 32-разрядные версии Windows поддерживают только одну группу. Если многопроцессорная система работает под управлением 64-разрядной версии Windows и содержит не более 64 логических процессоров, Windows назначает всем процессорам группировать 0. Многопроцессорная система под управлением 32-разрядной версии Windows может содержать не более 32 процессоров.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Доступно начиная с Windows 7. |
| целевая платформа | Всеобщий |
| заголовка | wdm.h (include Ntddk.h, Wdm.h, Ntddk.h) |
| библиотеки | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | Любой уровень |