Функция GetProcessDefaultCpuSetMasks (processthreadsapi.h)

Извлекает список наборов ЦП в наборе по умолчанию процесса, который был задан SetProcessDefaultCpuSetMasks или SetProcessDefaultCpuSets.

Синтаксис

BOOL GetProcessDefaultCpuSetMasks(
  HANDLE          Process,
  PGROUP_AFFINITY CpuSetMasks,
  USHORT          CpuSetMaskCount,
  PUSHORT         RequiredMaskCount
);

Параметры

Process

Задает дескриптор процесса для запроса процесса. Этот дескриптор должен иметь право доступа PROCESS_QUERY_LIMITED_INFORMATION . Значение, возвращаемое GetCurrentProcess , также можно указать здесь.

CpuSetMasks

Указывает необязательный буфер для получения списка структур GROUP_AFFINITY , представляющих наборы ЦП по умолчанию процесса.

CpuSetMaskCount

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

RequiredMaskCount

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

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

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

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

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

Замечания

Если наборы ЦП по умолчанию не заданы для заданного процесса, параметр RequiredMaskCount имеет значение 0, а функция завершается успешно.

Эта функция аналогична GetProcessDefaultCpuSets, за исключением того, что она использует сопоставления групп, а не идентификаторы набора ЦП для представления списка наборов ЦП. Это означает, что наборы ЦП по умолчанию по умолчанию сопоставляются со своими домашними процессорами, и эти процессоры извлекаются в результирующем списке сходств групп.

Требования