Функция GetNumaNodeProcessorMask2 (systemtopologyapi.h)

Извлекает маску процессора с несколькими группами указанного узла.

Синтаксис

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

Параметры

NodeNumber

Предоставляет отсчитываемый от нуля номер узла для интересующего узла.

ProcessorMasks

Массив структур GROUP_AFFINITY , который при успешном возвращении описывает маску процессора указанного узла.

Каждый элемент в массиве описывает набор процессоров, принадлежащих узлу в одной группе процессоров. В результирующем массиве будет по одному элементу для каждой группы процессоров, в которых этот узел содержит активные процессоры.

ProcessorMaskCount

Задает размер массива ProcessorMasks в элементах .

RequiredMaskCount

При успешном возвращении указывает количество структур сходства, записанных в массив.

Если входной массив был слишком мал, функция завершается сбоем с ERROR_INSUFFICIENT_BUFFER и задает для параметра RequiredMaskCount необходимое количество элементов.

Количество обязательных элементов всегда меньше или равно максимальному количеству групп, возвращаемого командлетом GetMaximumProcessorGroupCount.

Возвращаемое значение

Если функция выполняется успешно, возвращается ненулевое значение.

Если функция завершается сбоем, возвращаемое значение равно нулю, и расширенные сведения об ошибке можно получить, вызвав Метод GetLastError.

Если предоставленный массив слишком мал, значение ошибки ERROR_INSUFFICIENT_BUFFER а для параметра RequiredMaskCount задано необходимое количество элементов.

Если указан недопустимый параметр NodeNumber (т. е. больше значения, возвращаемого Методом GetNumaHighestNodeNumber), значение ошибки ERROR_INVALID_PARAMETER.

Комментарии

Если с указанным узлом не связаны процессоры (т. е. он содержит только память или периферийные устройства), то значение RequiredMaskCount будет иметь значение 0 и никакие структуры не будут записываться в массив.

Требования

См. также раздел

GetMaximumProcessorGroupCount