Share via

Función SetThreadGroupAffinity (processtopologyapi.h)

  • Artículo

Establece la afinidad de grupo de procesadores para el subproceso especificado.

Sintaxis

BOOL SetThreadGroupAffinity(
  [in]            HANDLE               hThread,
  [in]            const GROUP_AFFINITY *GroupAffinity,
  [out, optional] PGROUP_AFFINITY      PreviousGroupAffinity
);

Parámetros

[in] hThread

Identificador del subproceso.

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

[in] GroupAffinity

Estructura GROUP_AFFINITY que especifica la afinidad de grupo de procesadores que se usará para el subproceso especificado.

[out, optional] PreviousGroupAffinity

Puntero a una estructura de GROUP_AFFINITY para recibir la afinidad de grupo anterior del subproceso. Este parámetro puede ser NULL.

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, las afinidades de procesos y subprocesos abarcan todos los procesadores del sistema, en todos los grupos de procesadores, de forma predeterminada. La función SetThreadGroupAffinity restringe la afinidad de un subproceso a los procesadores a través del grupo de procesadores único especificado por el groupAffinity especificado por la groupAffinity especificada. Este grupo también se convertirá en el grupo principal del subproceso.

Para compilar una aplicación que usa esta función, establezca _WIN32_WINNT >= 0x0601. Para obtener más información, vea Usar 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
Library Kernel32.lib
Archivo DLL Kernel32.dll

Vea también

GROUP_AFFINITY