Функция GetThreadGroupAffinity (processtopologyapi.h)
Извлекает сходство группы обработчиков указанного потока.
Синтаксис
BOOL GetThreadGroupAffinity(
[in] HANDLE hThread,
[out] PGROUP_AFFINITY GroupAffinity
);
Параметры
[in] hThread
Дескриптор потока, для которого требуется сходство группы обработчиков.
Дескриптор должен иметь право доступа THREAD_QUERY_INFORMATION или THREAD_QUERY_LIMITED_INFORMATION. Дополнительные сведения см. в разделе Thread Security and Access Rights.
[out] GroupAffinity
Указатель на структуру GROUP_AFFINITY, которая получает сходство группы потока.
Возвращаемое значение
Если функция выполнена успешно, возвращаемое значение ненулевое.
Если функция завершается ошибкой, возвращаемое значение равно нулю. Чтобы получить расширенные сведения об ошибке, используйте GetLastError.
Замечания
Начиная с Windows 11 и Windows Server 2022, в системе с более чем 64 процессорами, процессами и сходствами потоков охватывают все процессоры в системе во всех группах процессоров по умолчанию. Функция GetThreadGroupAffinity извлекает сходство групп по основной группе потока.
Чтобы скомпилировать приложение, использующее эту функцию, задайте _WIN32_WINNT >= 0x0601. Дополнительные сведения см. в разделе Использование заголовков Windows.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Windows 7 [только классические приложения] |
| минимальный поддерживаемый сервер | Windows Server 2008 R2 [только классические приложения] |
| целевая платформа | Виндоус |
| заголовка | processtopologyapi.h (include Windows.h) |
| библиотеки | Kernel32.lib |
| DLL | Kernel32.dll |