GetNumaNodeProcessorMaskEx 함수(systemtopologyapi.h)

아티클
08/26/2023

노드가 속한 프로세서 그룹에 관계없이 노드의 프로세서 마스크를 검색합니다.

구문

BOOL GetNumaNodeProcessorMaskEx(
  [in]  USHORT          Node,
  [out] PGROUP_AFFINITY ProcessorMask
);

매개 변수

[in] Node

노드 번호입니다.

[out] ProcessorMask

지정된 노드에 대한 프로세서 마스크를 수신하는 GROUP_AFFINITY 구조체에 대한 포인터입니다. 프로세서 마스크는 각 비트가 프로세서를 나타내고 노드에 있는지 여부를 나타내는 비트 벡터입니다.

지정된 노드에 구성된 프로세서가 없는 경우 Mask 멤버는 0이고 그룹 멤버는 정의되지 않습니다.

반환 값

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

함수가 실패하면 반환 값은 0입니다.

설명

GetNumaNodeProcessorMaskEx 함수는 노드가 속한 그룹에 관계없이 노드의 프로세서 마스크를 검색할 수 있다는 점에서 GetNumaNodeProcessorMask와 다릅니다. 즉, 노드가 호출 스레드와 동일한 그룹에 있을 필요는 없습니다. GetNumaNodeProcessorMask 함수는 호출 스레드와 동일한 그룹에 있는 노드에 대해서만 프로세서 마스크를 검색할 수 있습니다.

시스템에서 번호가 가장 높은 노드를 검색하려면 GetNumaHighestNodeNumber 함수를 사용합니다. 이 숫자는 시스템의 총 노드 수와 동일하도록 보장되지 않습니다.

프로세스의 모든 스레드가 동일한 노드에서 실행되도록 하려면 동일한 노드의 프로세서를 지정하는 프로세스 선호도 마스크와 함께 SetProcessAffinityMask 함수를 사용합니다.

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

참고

TBD 릴리스 철부터 이 함수 및 기타 NUMA 함수의 동작이 64개 이상의 프로세서를 포함하는 노드가 있는 시스템을 더 잘 지원하도록 수정되었습니다. 이 API의 이전 동작을 사용하도록 설정하는 방법에 대한 정보를 포함하여 이 변경에 대한 자세한 내용은 NUMA 지원을 참조하세요.

TBD 릴리스 철로 시작하는 동작

각 노드에는 시스템에 의해 기본 그룹이 할당됩니다. GetNumaNodeProcessorMaskEx에서 반환된 GROUP_AFFINITY 노드의 기본 그룹에 대한 것입니다.

이전 버전의 동작

지정된 노드의 GROUP_AFFINITY 반환됩니다.

요구 사항

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