GetSystemCpuSetInformation 関数 (processthreadsapi.h)

アプリケーションがシステムで使用可能な CPU セットとその現在の状態に対してクエリを実行できるようにします。

構文

BOOL GetSystemCpuSetInformation(
  PSYSTEM_CPU_SET_INFORMATION Information,
  ULONG                       BufferLength,
  PULONG                      ReturnedLength,
  HANDLE                      Process,
  ULONG                       Flags
);

パラメーター

Information

CPU セット データを受け取る SYSTEM_CPU_SET_INFORMATION 構造体へのポインター。 バッファーの長さが 0 の NULL を渡して、必要なバッファー サイズを決定します。

BufferLength

Information 引数として渡される出力バッファーの長さ (バイト単位)。

ReturnedLength

バッファーが十分に大きい場合の出力バッファー内の有効なデータの長さ (バイト単位)、または出力バッファーの必要なサイズ。 CPU セットが存在しない場合、この値は 0 になります。

Process

プロセスへの省略可能なハンドル。 このプロセスは、SYSTEM_CPU_SET_INFORMATION構造体の AllocatedToTargetProcess フラグの値を決定するために使用されます。 CPU セットが指定されたプロセスに割り当てられている場合、フラグが設定されます。 それ以外の場合は明確です。 このハンドルには、PROCESS_QUERY_LIMITED_INFORMATIONアクセス権が必要です。 GetCurrentProcess によって返される値もここで指定できます。

Flags

予約済み。0 である必要があります。

戻り値

API が成功すると、TRUE が返されます。 失敗した場合、エラーの理由は GetLastError から入手できます。 Information バッファーが NULL であるか、十分な大きさでない場合は、エラー コード ERROR_INSUFFICIENT_BUFFERが返されます。 この API は、有効なパラメーターと、すべての戻りデータを保持するのに十分な大きさのバッファーを渡しても失敗しません。

要件

要件	値
サポートされている最小のクライアント	Windows 10
サポートされている最小のサーバー	WIndows Server 2016
Header	processthreadsapi.h