KeQueryGroupAffinity 함수(wdm.h)

KeQueryGroupAffinity 루틴은 다중 프로세서 시스템의 지정된 그룹에서 활성 논리 프로세서를 식별하는 선호도 마스크를 반환합니다.

구문

KAFFINITY KeQueryGroupAffinity(
  [in] USHORT GroupNumber
);

매개 변수

[in] GroupNumber

그룹 번호입니다. 다중 프로세서 시스템에 n 그룹이 포함된 경우 그룹은 0에서 n-1로 번호가 매겨집니다. 시스템의 활성 그룹 수를 가져오려면 KeQueryActiveGroupCount 루틴을 호출합니다.

반환 값

KeQueryGroupAffinity 는 지정된 그룹의 활성 논리 프로세서를 식별하는 KAFFINITY 값을 반환합니다. GroupNumber 매개 변수 값이 유효한 그룹 번호가 아니면 루틴은 0을 반환합니다.

설명

관련 루틴인 KeQueryActiveProcessors는 활성 프로세서 집합을 나타내는 선호도 마스크를 반환하지만 이 루틴은 KeQueryGroupAffinity와 달리 그룹 번호를 입력 매개 변수로 허용하지 않습니다. Windows 7 이상 버전의 Windows 운영 체제에서 KeQueryActiveProcessors 는 그룹을 지원하지 않는 이전 버전의 Windows에서 이 루틴의 동작과 호환되는 그룹 0의 활성 프로세서에 대한 선호도 마스크를 반환합니다. 이 동작은 KeQueryActiveProcessors 를 호출하고 그룹 지향 기능을 사용하지 않는 기존 드라이버가 둘 이상의 그룹이 있는 다중 프로세서 시스템에서 올바르게 실행되도록 합니다. 그러나 Windows 7 이상 버전의 Windows 운영 체제에서 그룹 지향 기능을 사용하는 드라이버는 KeQueryActiveProcessors 대신 KeQueryGroupAffinity를 호출해야 합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 7 및 이후 버전의 Windows에서 사용할 수 있습니다.
대상 플랫폼	유니버설
헤더	wdm.h(Wdm.h, Ntddk.h, Ntifs.h 포함)
라이브러리	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	모든 수준

추가 정보

KAFFINITY

KeQueryActiveProcessors