KeQueryMaximumProcessorCountEx 함수(wdm.h)

KeQueryMaximumProcessorCountEx 루틴은 다중 프로세서 시스템의 지정된 그룹에 있는 논리 프로세서의 최대 수를 반환합니다.

구문

ULONG KeQueryMaximumProcessorCountEx(
  [in] USHORT GroupNumber
);

매개 변수

[in] GroupNumber

그룹 번호를 지정합니다. 다중 프로세서 시스템에 n 그룹이 포함된 경우 그룹은 0에서 n-1로 번호가 매겨집니다. 시스템에서 최대 프로세서 수를 가져오려면 이 매개 변수를 winnt.h 및 Ntdef.h 헤더 파일에 정의된 ALL_PROCESSOR_GROUPS 설정합니다.

반환 값

KeQueryMaximumProcessorCountEx 는 GroupNumber 매개 변수 값으로 표시된 대로 지정된 그룹 또는 시스템의 최대 논리 프로세서 수를 반환합니다.

설명

KeQueryMaximumProcessorCountEx에서 반환되는 값은 런타임 동안 일정하게 유지됩니다. 이 값은 다중 프로세서 시스템의 하드웨어 구성에 따라 달라지지만 Windows 운영 체제에서 설정한 고정 제한을 초과할 수는 없습니다. 이 제한은 32비트 버전의 Windows용 논리 프로세서 32개, Windows 64비트 버전의 논리 프로세서 64개입니다.

반면, 프로세서가 시스템에 동적으로 추가되면 런타임 중에 KeQueryActiveProcessorCountEx 루틴에서 반환되는 값이 변경됩니다.

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

요구 사항

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

추가 정보

KeQueryActiveProcessorCountEx

KeQueryMaximumProcessorCount