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

Возвращает явное назначение набора ЦП указанного потока, если любое назначение было задано с помощью SetThreadSelectedCpuSetMasks или SetThreadSelectedCpuSets.

Синтаксис

BOOL GetThreadSelectedCpuSetMasks(
  HANDLE          Thread,
  PGROUP_AFFINITY CpuSetMasks,
  USHORT          CpuSetMaskCount,
  PUSHORT         RequiredMaskCount
);

Параметры

Thread

Указывает поток, для которого запрашиваются выбранные наборы ЦП. Этот дескриптор должен иметь право доступа PROCESS_QUERY_LIMITED_INFORMATION . Значение, возвращаемое GetCurrentProcess , также можно указать здесь.

CpuSetMasks

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

CpuSetMaskCount

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

RequiredMaskCount

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

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

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

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

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

Замечания

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

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

Требования