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
);
매개 변수
-
정보 [out, optional]
-
CPU 집합 데이터를 수신하는 SYSTEM_CPU_SET_INFORMATION 구조체에 대한 포인터입니다. 버퍼 길이가 0인 NULL을 전달하여 필요한 버퍼 크기를 확인합니다.
-
BufferLength [in]
-
Information 인수로 전달된 출력 버퍼의 길이(바이트)입니다.
-
ReturnedLength [out]
-
버퍼가 충분히 크거나 출력 버퍼의 필요한 크기인 경우 출력 버퍼의 유효한 데이터의 길이(바이트)입니다. CPU 집합이 없으면 이 값은 0이 됩니다.
-
프로세스 [in, optional]
-
프로세스에 대한 선택적 핸들입니다. 이 프로세스는 SYSTEM_CPU_SET_INFORMATION 구조에서 AllocatedToTargetProcess 플래그의 값을 결정하는 데 사용됩니다. CPU 집합이 지정된 프로세스에 할당되면 플래그가 설정됩니다. 그렇지 않으면 분명합니다. 이 핸들에는 PROCESS_QUERY_LIMITED_INFORMATION 액세스 권한이 있어야 합니다. GetCurrentProcess에서 반환되는 값도 여기에 지정할 수 있습니다.
-
플래그
-
예약됨, 0이어야 합니다.
반환 값
API가 성공하면 TRUE를 반환합니다. 실패하면 GetLastError를 통해 오류 이유를 사용할 수 있습니다. 정보 버퍼가 NULL이거나 충분히 크지 않은 경우 ERROR_INSUFFICIENT_BUFFER 오류 코드가 반환됩니다. 유효한 매개 변수와 모든 반환 데이터를 저장할 수 있을 만큼 큰 버퍼를 전달하면 이 API가 실패할 수 없습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 |
Windows 10 [데스크톱 앱 | UWP 앱] |
| 지원되는 최소 서버 |
Windows Server 2016 [데스크톱 앱 | UWP 앱] |
| 헤더 |
|
| 라이브러리 |
|
| DLL |
|