GetNumaNodeProcessorMask2 함수(systemtopologyapi.h)

  • 아티클

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

구문

BOOL GetNumaNodeProcessorMask2(
  USHORT          NodeNumber,
  PGROUP_AFFINITY ProcessorMasks,
  USHORT          ProcessorMaskCount,
  PUSHORT         RequiredMaskCount
);

매개 변수

NodeNumber

관심 있는 노드에 대한 0부터 시작하는 노드 번호를 제공합니다.

ProcessorMasks

반환이 성공하면 지정된 노드의 프로세서 마스크를 설명하는 GROUP_AFFINITY 구조체의 배열입니다.

배열의 각 요소는 단일 프로세서 그룹 내의 노드에 속하는 프로세서 집합을 설명합니다. 이 노드에 활성 프로세서가 있는 각 프로세서 그룹에 대한 결과 배열에는 하나의 요소가 있습니다.

ProcessorMaskCount

ProcessorMasks 배열의 크기를 요소로 지정합니다.

RequiredMaskCount

반환에 성공하면 배열에 기록된 선호도 구조의 수를 지정합니다.

입력 배열이 너무 작으면 함수가 ERROR_INSUFFICIENT_BUFFER 실패하고 RequiredMaskCount 매개 변수를 필요한 요소 수로 설정합니다.

필요한 요소의 수는 항상 GetMaximumProcessorGroupCount에서 반환하는 최대 그룹 수보다 작거나 같습니다.

반환 값

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

함수가 실패하면 반환 값이 0이고 GetLastError를 호출하여 확장된 오류 정보를 검색할 수 있습니다.

제공된 배열이 너무 작으면 오류 값이 ERROR_INSUFFICIENT_BUFFER RequiredMaskCount 매개 변수가 필요한 요소 수로 설정됩니다.

제공된 NodeNumber 가 유효하지 않은 경우(예: GetNumaHighestNodeNumber에서 반환된 값보다 크면) 오류 값이 ERROR_INVALID_PARAMETER.

설명

지정된 노드에 연결된 프로세서가 없는 경우(즉, 메모리 또는 주변 장치만 포함) 반환된 RequiredMaskCount 는 0이 되고 배열에 구조체가 기록되지 않습니다.

요구 사항

   
지원되는 최소 클라이언트 Windows 10 빌드 20348
지원되는 최소 서버 Windows 10 빌드 20348
머리글 systemtopologyapi.h

추가 정보

GetMaximumProcessorGroupCount