Функция GetProcessGroupAffinity (processtopologyapi.h)
Извлекает сходство группы процессоров указанного процесса.
Синтаксис
BOOL GetProcessGroupAffinity(
[in] HANDLE hProcess,
[in, out] PUSHORT GroupCount,
[out] PUSHORT GroupArray
);
Параметры
[in] hProcess
Дескриптор процесса.
Этот дескриптор должен иметь право доступа PROCESS_QUERY_INFORMATION или PROCESS_QUERY_LIMITED_INFORMATION. Дополнительные сведения см. в разделе Обработка прав на безопасность и доступ.
[in, out] GroupCount
На входе указывает количество элементов в массиве GroupArray . В выходных данных указывает количество групп процессоров, записанных в массив. Если массив слишком мал, функция завершается сбоем с ERROR_INSUFFICIENT_BUFFER и задает параметру GroupCount необходимое количество элементов.
[out] GroupArray
Массив номеров групп процессоров. Номер группы включается в массив, если поток в процессе назначается обработчику в группе.
Возвращаемое значение
Если функция выполняется успешно, возвращается ненулевое значение.
Если функция выполняется неудачно, возвращается нулевое значение. Чтобы получить расширенные сведения об ошибке, используйте GetLastError.
Если значение ошибки ERROR_INSUFFICIENT_BUFFER, параметр GroupCount содержит требуемый размер буфера в количестве элементов.
Комментарии
Начиная с Windows 11 и Windows Server 2022, в системе с более чем 64 процессорами сходство процессов и потоков по умолчанию охватывает все процессоры в системе во всех группах процессоров.
Чтобы скомпилировать приложение, использующее эту функцию, задайте _WIN32_WINNT >= 0x0601. Дополнительные сведения см. в разделе Использование заголовков Windows.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 7 [только классические приложения] |
| Минимальная версия сервера | Windows Server 2008 R2 [только классические приложения] |
| Целевая платформа | Windows |
| Header | processtopologyapi.h (включая Windows.h в Windows Server 2008 Windows Server 2008 R2) |
| Библиотека | Kernel32.lib |
| DLL | Kernel32.dll |