Функция 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
При входных данных указывает количество элементов в массиве GroupArra y. В выходных данных указывает количество групп процессоров, записанных в массив. Если массив слишком мал, функция завершается ошибкой 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 [только классические приложения] |
| целевая платформа | Виндоус |
| заголовка | processtopologyapi.h (включая Windows.h в Windows Server 2008 Windows Server 2008 R2) |
| библиотеки | Kernel32.lib |
| DLL | Kernel32.dll |