GetSystemCpuSetInformation 関数

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

構文

BOOL WINAPI GetSystemCpuSetInformation(
  _Out_opt_  PSYSTEM_CPU_SET_INFORMATION  Information,
  _In_       ULONG                        BufferLength,
  _Out_      PULONG                       ReturnedLength,
  _In_opt_   HANDLE                       Process,
  _Reserved_ ULONG                        Flags
);

パラメーター

情報 [出力、省略可能]

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

BufferLength [in]

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

ReturnedLength [out]

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

プロセス [入力、省略可能]

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

Flags

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

戻り値

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

要件