GetProcessDefaultCpuSetMasks 함수(processthreadsapi.h)

SetProcessDefaultCpuSetMasks 또는 SetProcessDefaultCpuSets로 설정된 프로세스 기본 집합의 CPU 집합 목록을 검색합니다.

구문

BOOL GetProcessDefaultCpuSetMasks(
  HANDLE          Process,
  PGROUP_AFFINITY CpuSetMasks,
  USHORT          CpuSetMaskCount,
  PUSHORT         RequiredMaskCount
);

매개 변수

Process

쿼리할 프로세스에 대한 프로세스 핸들을 지정합니다. 이 핸들에는 PROCESS_QUERY_LIMITED_INFORMATION 액세스 권한이 있어야 합니다. GetCurrentProcess에서 반환되는 값도 여기에서 지정할 수 있습니다.

CpuSetMasks

프로세스 기본 CPU 집합을 나타내는 GROUP_AFFINITY 구조 목록을 검색하는 선택적 버퍼를 지정합니다.

CpuSetMaskCount

요소에서 CpuSetMasks 배열의 크기를 지정합니다.

RequiredMaskCount

반환에 성공하면 배열에 기록된 선호도 구조의 수를 지정합니다. CpuSetMasks 배열이 너무 작으면 함수가 ERROR_INSUFFICIENT_BUFFER 실패하고 RequiredMaskCount 매개 변수를 필요한 요소 수로 설정합니다. 필요한 요소의 수는 항상 GetMaximumProcessorGroupCount에서 반환하는 최대 그룹 수보다 작거나 같습니다.

반환 값

함수가 성공하면 반환 값이 0이 아닙니다.

함수가 실패하면 반환 값이 0이고 GetLastError를 호출하여 확장된 오류 정보를 검색할 수 있습니다.

제공된 배열이 너무 작으면 오류 값이 ERROR_INSUFFICIENT_BUFFERRequiredMaskCount 가 필요한 요소 수로 설정됩니다.

설명

지정된 프로세스에 대해 기본 CPU 집합이 설정되지 않은 경우 RequiredMaskCount 매개 변수가 0으로 설정되고 함수가 성공합니다.

이 함수는 CPU 집합 ID가 아닌 그룹 친화성을 사용하여 CPU 집합 목록을 나타낸다는 점을 제외하고 GetProcessDefaultCpuSets와 유사합니다. 즉, 프로세스 기본 CPU 집합은 홈 프로세서에 매핑되고 해당 프로세서는 결과 그룹 친화 목록에서 검색됩니다.

요구 사항

지원되는 최소 클라이언트	Windows 11
지원되는 최소 서버	Windows Server 2022
머리글	processthreadsapi.h
DLL	kernel32.dll