KeGetProcessorIndexFromNumber 関数 (ntifs.h)

KeGetProcessorIndexFromNumber ルーチンは、グループ番号とグループ相対プロセッサ番号をシステム全体のプロセッサ インデックスに変換します。

構文

ULONG KeGetProcessorIndexFromNumber(
  [in] PPROCESSOR_NUMBER ProcNumber
);

パラメーター

[in] ProcNumber

グループ番号とグループ相対プロセッサ番号を含む呼び出し元によって割り当てられた PROCESSOR_NUMBER 構造体へのポインター。

戻り値

KeGetProcessorIndexFromNumber は、呼び出しが成功した場合にシステム全体のプロセッサ インデックスを返します。 ProcNumber が無効な PROCESSOR_NUMBER 値を指している場合、ルーチンは wdm.h ヘッダー ファイルで定義されているINVALID_PROCESSOR_INDEXを返します。

備考

このルーチンは、グループ番号とそのグループ内のプロセッサ番号によってプロセッサを識別する PROCESSOR_NUMBER 構造体を入力として受け入れます。 戻り値は、マルチプロセッサ システム全体のプロセッサを識別するプロセッサ インデックスです。

たとえば、マルチプロセッサ システムに 2 つのグループが含まれており、各グループに 64 個の論理プロセッサが含まれている場合、各グループのプロセッサ番号の範囲は 0 から 63 ですが、システム全体のプロセッサ インデックスの範囲は 0 から 127 です。

システム内のアクティブな論理プロセッサの合計数を取得するには、KeQueryActiveProcessorCountEx ルーチンを呼び出し、このルーチンの GroupNumber パラメーターをALL_PROCESSOR_GROUPSに設定します。

KeGetProcessorNumberFromIndex ルーチンは、システム全体のプロセッサ インデックスをグループ番号とグループ相対プロセッサ番号に変換します。

必要条件

要件	価値
サポートされる最小クライアント	Windows 7
ターゲット プラットフォーム の	万国
ヘッダー	ntifs.h (Wdm.h、Ntddk.h、Ntifs.h を含む)
ライブラリ	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	任意のレベル

関連項目

KeGetProcessorNumberFromIndex

KeQueryActiveProcessorCountEx の

PROCESSOR_NUMBER