GetProcessGroupAffinity 함수(processtopologyapi.h)

지정된 프로세스의 프로세서 그룹 선호도를 검색합니다.

구문

BOOL GetProcessGroupAffinity(
  [in]      HANDLE  hProcess,
  [in, out] PUSHORT GroupCount,
  [out]     PUSHORT GroupArray
);

[in] hProcess

프로세스에 대한 핸들입니다.

이 핸들에는 PROCESS_QUERY_INFORMATION 또는 PROCESS_QUERY_LIMITED_INFORMATION 액세스 권한이 있어야 합니다. 자세한 내용은 프로세스 보안 및 액세스 권한을 참조하세요.

[in, out] GroupCount

입력에서 GroupArray 배열의 요소 수를 지정합니다. 출력에서 배열에 기록된 프로세서 그룹의 수를 지정합니다. 배열이 너무 작으면 함수가 ERROR_INSUFFICIENT_BUFFER 실패하고 GroupCount 매개 변수를 필요한 요소 수로 설정합니다.

[out] GroupArray

프로세서 그룹 번호의 배열입니다. 프로세스의 스레드가 그룹의 프로세서에 할당된 경우 그룹 번호가 배열에 포함됩니다.

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

함수가 실패하면 반환 값은 0입니다. 확장 오류 정보를 얻으려면 GetLastError를 사용합니다.

오류 값이 ERROR_INSUFFICIENT_BUFFER 경우 GroupCount 매개 변수에는 요소 수에 필요한 버퍼 크기가 포함됩니다.

Windows 11 및 Windows Server 2022부터 64개 이상의 프로세서가 있는 시스템에서 프로세스 및 스레드 친화성은 기본적으로 시스템의 모든 프로세서, 모든 프로세서 그룹에 걸쳐 있습니다.

이 함수를 사용하는 애플리케이션을 컴파일하려면 _WIN32_WINNT >= 0x0601 설정합니다. 자세한 내용은 Windows 헤더 사용을 참조하세요.

요구 사항	값
지원되는 최소 클라이언트	Windows 7 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 R2 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	processtopologyapi.h(Windows Server 2008 Windows Server 2008 R2에 Windows.h 포함)
라이브러리	Kernel32.lib
DLL	Kernel32.dll