KeGetProcessorIndexFromNumber 関数 (wdm.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 以降のバージョンの Windows で使用できます。
対象プラットフォーム ユニバーサル
Header wdm.h (Wdm.h、Ntddk.h、Ntifs.h を含む)
Library NtosKrnl.lib
[DLL] NtosKrnl.exe
IRQL 任意のレベル

こちらもご覧ください

KeGetProcessorNumberFromIndex

KeQueryActiveProcessorCountEx

PROCESSOR_NUMBER