KeQueryGroupAffinity 関数 (wdm.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	wdm.h (Wdm.h、Ntddk.h、Ntifs.h を含む)
Library	NtosKrnl.lib
[DLL]	NtosKrnl.exe
IRQL	任意のレベル

こちらもご覧ください

KAFFINITY

KeQueryActiveProcessors