GetNumaNodeProcessorMaskEx 함수(systemtopologyapi.h)
노드가 속한 프로세서 그룹에 관계없이 노드의 프로세서 마스크를 검색합니다.
구문
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 |