Функция 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