次の方法で共有


KeQueryActiveGroupCount 関数 (ntddk.h)

KeQueryActiveGroupCount ルーチンは、マルチプロセッサ システム内のアクティブなプロセッサ グループの数を返します。

構文

USHORT KeQueryActiveGroupCount();

戻り値

KeQueryActiveGroupCount は、アクティブなグループの数を返します。

備考

1 つ以上のアクティブな論理プロセッサが含まれている場合、プロセッサ グループはアクティブです。

アクティブな論理プロセッサは、Windows が起動してマルチプロセッサ システムに追加した論理プロセッサです。 アクティブなプロセッサ という用語は、プロセッサが現在処理作業を実行しているかアイドル状態であるかに関係なく、処理作業を実行できるプロセッサに適用されます。 システムによっては、アクティブなプロセッサの数がシステムの起動からシャットダウンまで変わらない場合があります。 他のシステムでは、システムの実行中に、Windows によってアクティブなプロセッサが動的に追加される場合があります。 Windows では、アクティブなプロセッサがシステムから削除されることはありません。

したがって、マルチプロセッサ システム内のアクティブなプロセッサの数は、システムの起動とシャットダウンの間に増加する可能性がありますが、この数が減少することはありません。 同様に、システムの実行中にプロセッサーが非アクティブ・グループに動的に追加されると、システム内のアクティブ・グループの数が増える可能性があります。 アクティブなグループの数が減少することはありません。

これに対し、KeQueryMaximumGroupCount によって返される値は、実行時に一定のままです。 この値は、システムで使用できるグループの最大数です。

KeQueryActiveProcessorCountEx ルーチンを呼び出して、特定のグループ内のアクティブな論理プロセッサの数を決定します。

Windows 7 は、プロセッサ グループをサポートする Windows の最初のバージョンです。 Windows 7 では、64 ビット バージョンの Windows のみが複数のグループをサポートします。32 ビット バージョンの Windows では、1 つのグループのみがサポートされます。 32 ビット バージョンの Windows を実行しているマルチプロセッサ システムには、32 個以下のプロセッサを含めることができます。

必要条件

要件 価値
サポートされる最小クライアント Windows 7 以降で使用できます。
ターゲット プラットフォーム 万国
ヘッダー ntddk.h (Ntddk.h、Wdm.h、Ntddk.h を含む)
ライブラリ NtosKrnl.lib
DLL NtosKrnl.exe
IRQL 任意のレベル

関連項目

KeQueryActiveProcessorCountEx

KeQueryMaximumGroupCount