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 で使用できます。 |
| ターゲット プラットフォーム の | 万国 |
| ヘッダー | ntddk.h (Wdm.h、Ntddk.h、Ntifs.h を含む) |
| ライブラリ | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | 任意のレベル |