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

Статья
08/25/2023

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

Синтаксис

BOOL GetThreadGroupAffinity(
  [in]  HANDLE          hThread,
  [out] PGROUP_AFFINITY GroupAffinity
);

Параметры

[in] hThread

Дескриптор потока, для которого требуется сходство группы процессоров.

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

[out] GroupAffinity

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

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

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

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

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

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

Требования

Требование	Значение
Минимальная версия клиента	Windows 7 [только классические приложения]
Минимальная версия сервера	Windows Server 2008 R2 [только классические приложения]
Целевая платформа	Windows
Header	processtopologyapi.h (включая Windows.h)
Библиотека	Kernel32.lib
DLL	Kernel32.dll

См. также

GetProcessGroupAffinity

Группы процессоров

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