Поделиться через

Функция 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, за исключением того, что она использует сходства групп в отличие от идентификаторов наборов ЦП для представления списка наборов ЦП. Это означает, что выбранные потоком наборы ЦП сопоставляются с их домашними процессорами, и эти процессоры извлекаются в результирующем списке сопоставлений групп.

Требования

Требование Значение
Минимальная версия клиента Windows 11
Минимальная версия сервера Windows Server 2022
Верхняя часть processthreadsapi.h
DLL kernel32.dll