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를 통해 오류 이유를 사용할 수 있습니다. 정보 버퍼가 NULL이거나 충분히 크지 않은 경우 ERROR_INSUFFICIENT_BUFFER 오류 코드가 반환됩니다. 유효한 매개 변수와 모든 반환 데이터를 저장할 수 있을 만큼 큰 버퍼를 전달하면 이 API가 실패할 수 없습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 10
지원되는 최소 서버	WIndows Server 2016
머리글	processthreadsapi.h