GetNumaNodeProcessorMask 함수(winbase.h)

아티클
03/03/2024

지정된 노드의 프로세서 마스크를 검색합니다.

구문

BOOL GetNumaNodeProcessorMask(
  [in]  UCHAR      Node,
  [out] PULONGLONG ProcessorMask
);

매개 변수

[in] Node

노드 수입니다.

[out] ProcessorMask

노드의 프로세서 마스크입니다. 프로세서 마스크는 각 비트가 프로세서를 나타내고 노드에 있는지 여부를 나타내는 비트 벡터입니다.

노드에 구성된 프로세서가 없는 경우 프로세서 마스크는 0입니다.

64개 이상의 프로세서가 있는 시스템에서 이 매개 변수는 노드가 호출 스레드와 동일한 프로세서 그룹에 있는 경우에만 노드의 프로세서 마스크로 설정됩니다. 그렇지 않으면 매개 변수가 0으로 설정됩니다.

반환 값

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

함수가 실패하면 반환 값은 0입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

설명

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

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

GetNumaNodeProcessorMaskEx 함수를 사용하여 프로세서 그룹의 노드에 대한 프로세서 마스크를 검색합니다.

참고

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

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

각 노드에는 시스템에 의해 기본 그룹이 할당됩니다. GetNumaNodeProcessorMask에서 반환된 마스크는 노드의 기본 그룹에 대한 것이며 호출 스레드가 해당 그룹에 속하는 경우에만 반환됩니다.

이전 버전의 동작

지정된 노드의 마스크가 반환됩니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista, Windows XP Professional x64 Edition, WINDOWS XP SP2 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	winbase.h(Windows.h 포함)
라이브러리	Kernel32.lib
DLL	Kernel32.dll