KeGetProcessorNumberFromIndex 関数 (wdm.h)
KeGetProcessorNumberFromIndex ルーチンは、システム全体のプロセッサ インデックスをグループ番号とグループ相対プロセッサ番号に変換します。
構文
NTSTATUS KeGetProcessorNumberFromIndex(
[in] ULONG ProcIndex,
[out] PPROCESSOR_NUMBER ProcNumber
);
パラメーター
[in] ProcIndex
システム全体のプロセッサ インデックス。 マルチプロセッサ システムに合計 n 個 の論理プロセッサが含まれている場合、有効なプロセッサ インデックスの範囲は 0 から n から 1 です。
[out] ProcNumber
ProcIndex によって識別されるプロセッサのグループ番号とグループ相対プロセッサ番号をルーチンが書き込む呼び出し元によって割り当てられたPROCESSOR_NUMBER構造体へのポインター。
戻り値
KeGetProcessorNumberFromIndex は、呼び出しが成功した場合にSTATUS_SUCCESSを返します。 考えられるエラーの戻り値は次のとおりです。
| リターン コード | 説明 |
|---|---|
| STATUS_INVALID_PARAMETER | ProcIndex パラメーター値が有効なプロセッサ インデックスではありません。 |
注釈
このルーチンは、マルチプロセッサ システム全体のプロセッサを識別するプロセッサ インデックスを入力として受け取ります。 出力値は、グループ番号とそのグループ内のプロセッサ番号によってプロセッサを識別する PROCESSOR_NUMBER 構造体です。
たとえば、マルチプロセッサ システムに 2 つのグループが含まれており、各グループに 64 個の論理プロセッサが含まれている場合、各グループのプロセッサ番号は 0 から 63 の範囲ですが、システム全体のプロセッサ インデックスの範囲は 0 から 127 です。
システム内のアクティブな論理プロセッサの合計数を取得するには、 KeQueryActiveProcessorCountEx ルーチンを呼び出します。
KeGetProcessorIndexFromNumber ルーチンは、グループ番号とグループ相対プロセッサ番号をシステム全体のプロセッサ インデックスに変換します。
例
次のコード例では、 KeQueryActiveProcessorCountEx ルーチンと KeGetProcessorNumberFromIndex ルーチンを使用して、システム内のすべてのアクティブな論理プロセッサを列挙します。
ULONG Count;
ULONG ProcIndex;
PROCESSOR_NUMBER ProcNumber;
Count = KeQueryActiveProcessorCountEx(ALL_PROCESSOR_GROUPS);
for (ProcIndex = 0; ProcIndex < Count; ProcIndex += 1)
{
KeGetProcessorNumberFromIndex(ProcIndex, &ProcNumber);
// Do something with the contents of ProcNumber.
...
}
ALL_PROCESSOR_GROUPS定数値は、Winnt.h および Ntdef.h で定義されます。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 7 以降のバージョンの Windows で使用できます。 |
| 対象プラットフォーム | ユニバーサル |
| Header | wdm.h (Ntddk.h、Wdm.h、Ntddk.h、Ntifs.h を含む) |
| Library | NtosKrnl.lib |
| [DLL] | NtosKrnl.exe |
| IRQL | 任意のレベル |