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 | 任意のレベル |