Función GetThreadGroupAffinity (processtopologyapi.h)

Recupera la afinidad de grupo de procesadores del subproceso especificado.

Sintaxis

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

Parámetros

[in] hThread

Identificador del subproceso para el que se desea la afinidad de grupo de procesadores.

El identificador debe tener el derecho de acceso THREAD_QUERY_INFORMATION o THREAD_QUERY_LIMITED_INFORMATION. Para obtener más información, consulte Derechos de acceso y seguridad de subprocesos.

[out] GroupAffinity

Puntero a una estructura de GROUP_AFFINITY para recibir la afinidad de grupo del subproceso.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, use GetLastError.

Comentarios

A partir de Windows 11 y Windows Server 2022, en un sistema con más de 64 procesadores, afinidades de procesos y subprocesos abarcan todos los procesadores del sistema, en todos los grupos de procesadores, de forma predeterminada. La función GetThreadGroupAffinity recupera la afinidad de grupo sobre el grupo principal del subproceso.

Para compilar una aplicación que use esta función, establezca _WIN32_WINNT >= 0x0601. Para obtener más información, vea Uso de los encabezados de Windows.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 R2 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	processtopologyapi.h (incluya Windows.h)
Library	Kernel32.lib
Archivo DLL	Kernel32.dll

Vea también

GetProcessGroupAffinity

Grupos de procesadores