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

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

KeQueryActiveProcessorCountEx

KeQueryMaximumGroupCount