Поделиться через


Функция KeQueryActiveGroupCount (ntddk.h)

Подпрограмма KeQueryActiveGroupCount возвращает количество активных групп обработчиков в многопроцессорной системе.

Синтаксис

USHORT KeQueryActiveGroupCount();

Возвращаемое значение

KeQueryActiveGroupCount возвращает количество активных групп.

Замечания

Группа обработчиков активна, если она содержит один или несколько активных логических процессоров.

Активный логический процессор — это логический процессор, запущенный и добавленный в систему с несколькими процессорами Windows. Термин активного процессора применяется к процессору, который доступен для выполнения обработки, независимо от того, выполняется ли обработчик в настоящее время выполняет обработку или находится в состоянии простоя. В некоторых системах число активных процессоров может оставаться неизменным от запуска системы до завершения работы. В других системах Windows может динамически добавлять активные процессоры во время работы системы. Windows никогда не удаляет активные процессоры из системы.

Таким образом, число активных процессоров в многопроцессорной системе может увеличиваться между запуском системы и завершением работы, но это число никогда не уменьшается. Аналогичным образом, число активных групп в системе может увеличиться, если процессор динамически добавляется в неактивную группу во время работы системы. Количество активных групп никогда не уменьшается.

В отличие от этого, значение, возвращаемое KeQueryMaximumGroupCount остается постоянным во время выполнения. Это значение — максимальное количество групп, которые может иметь система.

Вызовите подпрограмму KeQueryActiveProcessorCountEx, чтобы определить количество активных логических процессоров в определенной группе.

Windows 7 — это первая версия Windows для поддержки групп процессоров. В Windows 7 только 64-разрядные версии Windows поддерживают несколько групп; 32-разрядные версии Windows поддерживают только одну группу. Многопроцессорная система под управлением 32-разрядной версии Windows может содержать не более 32 процессоров.

Требования

Требование Ценность
минимальные поддерживаемые клиентские Доступно начиная с Windows 7.
целевая платформа Всеобщий
заголовка ntddk.h (include Ntddk.h, Wdm.h, Ntddk.h)
библиотеки NtosKrnl.lib
DLL NtosKrnl.exe
IRQL Любой уровень

См. также

KeQueryActiveProcessorCountEx

KeQueryMaximumGroupCount