Функция 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.

Требования

См. также

GetThreadGroupAffinity

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