KeQueryGroupAffinity 関数 (ntddk.h)

KeQueryGroupAffinity ルーチンは、マルチプロセッサ システム内の指定されたグループ内のアクティブな論理プロセッサを識別するアフィニティ マスクを返します。

構文

KAFFINITY KeQueryGroupAffinity(
  [in] USHORT GroupNumber
);

パラメーター

[in] GroupNumber

グループ番号。 マルチプロセッサ システムに n 個のグループが含まれている場合、グループには 0 から n-1 の番号が付きます。 システム内のアクティブなグループの数を取得するには、 KeQueryActiveGroupCount ルーチンを呼び出します。

戻り値

KeQueryGroupAffinity は、指定されたグループ内のアクティブな論理プロセッサを識別する KAFFINITY 値を返します。 GroupNumber パラメーター値が有効なグループ番号でない場合、ルーチンは 0 を返します。

注釈

関連ルーチン KeQueryActiveProcessors は、アクティブなプロセッサのセットを表すアフィニティ マスクを返しますが、 KeQueryGroupAffinity とは異なり、このルーチンは入力パラメーターとしてグループ番号を受け取りません。 Windows 7 以降のバージョンの Windows オペレーティング システムでは、 KeQueryActiveProcessors はグループ 0 のアクティブ プロセッサのアフィニティ マスクを返します。これは、グループをサポートしていない以前のバージョンの Windows でのこのルーチンの動作と互換性があります。 この動作により、 KeQueryActiveProcessors を呼び出し、グループ指向機能を使用しない既存のドライバーが、2 つ以上のグループを持つマルチプロセッサ システムで正しく実行されるようになります。 ただし、Windows 7 以降のバージョンの Windows オペレーティング システムでグループ指向機能を使用するドライバーでは、KeQueryActiveProcessors ではなく KeQueryGroupAffinity を呼び出す必要があります。

要件

要件
サポートされている最小のクライアント Windows 7 以降のバージョンの Windows で使用できます。
対象プラットフォーム ユニバーサル
Header ntddk.h (Wdm.h、Ntddk.h、Ntifs.h を含む)
Library NtosKrnl.lib
[DLL] NtosKrnl.exe
IRQL 任意のレベル

こちらもご覧ください

KAFFINITY

KeQueryActiveProcessors