GetThreadSelectedCpuSetMasks 함수(processthreadsapi.h)

SetThreadSelectedCpuSetMasks 또는 SetThreadSelectedCpuSets를 사용하여 할당이 설정된 경우 지정된 스레드의 명시적 CPU 집합 할당을 반환합니다.

구문

BOOL GetThreadSelectedCpuSetMasks(
  HANDLE          Thread,
  PGROUP_AFFINITY CpuSetMasks,
  USHORT          CpuSetMaskCount,
  PUSHORT         RequiredMaskCount
);

매개 변수

Thread

선택한 CPU 집합을 쿼리할 스레드를 지정합니다. 이 핸들에는 PROCESS_QUERY_LIMITED_INFORMATION 액세스 권한이 있어야 합니다. GetCurrentProcess에서 반환되는 값도 여기에 지정할 수 있습니다.

CpuSetMasks

선택한 스레드 CPU 집합을 나타내는 GROUP_AFFINITY 구조 목록을 검색하는 선택적 버퍼를 지정합니다.

CpuSetMaskCount

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

RequiredMaskCount

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

반환 값

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

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

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

설명

명시적 할당이 설정되지 않으면 RequiredMaskCount 가 0으로 설정되고 함수가 성공합니다.

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

요구 사항

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