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 は失敗しません。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント |
Windows 10 [デスクトップ アプリ |UWP アプリ] |
サポートされている最小のサーバー |
Windows Server 2016 [デスクトップ アプリ |UWP アプリ] |
Header |
|
ライブラリ |
|
[DLL] |
|