Функция SetThreadGroupAffinity (processtopologyapi.h)

Задает сходство группы процессоров для указанного потока.

Синтаксис

BOOL SetThreadGroupAffinity(
  [in]            HANDLE               hThread,
  [in]            const GROUP_AFFINITY *GroupAffinity,
  [out, optional] PGROUP_AFFINITY      PreviousGroupAffinity
);

Параметры

[in] hThread

Дескриптор потока.

Дескриптор должен иметь право доступа к THREAD_SET_INFORMATION. Дополнительные сведения см. в разделе Безопасность потоков и права доступа.

[in] GroupAffinity

Структура GROUP_AFFINITY , указывающая сходство группы процессоров, которая будет использоваться для указанного потока.

[out, optional] PreviousGroupAffinity

Указатель на структуру GROUP_AFFINITY для получения предыдущего сходства группы потока. Этот параметр может принимать значение NULL.

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

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

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

Комментарии

Начиная с Windows 11 и Windows Server 2022, в системе с более чем 64 процессорами сходство процессов и потоков по умолчанию охватывает все процессоры в системе во всех группах процессоров. Функция SetThreadGroupAffinity ограничивает сходство потока процессорами по группе с одним процессором, указанной в заданной группе GroupAffinity. Эта группа также станет основной группой потока.

Чтобы скомпилировать приложение, использующее эту функцию, задайте _WIN32_WINNT >= 0x0601. Дополнительные сведения см. в разделе Использование заголовков Windows.

Требования

См. также

GROUP_AFFINITY