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 |