Share via

Función GetProcessGroupAffinity (processtopologyapi.h)

  • Artículo

Recupera la afinidad de grupo de procesadores del proceso especificado.

Sintaxis

BOOL GetProcessGroupAffinity(
  [in]      HANDLE  hProcess,
  [in, out] PUSHORT GroupCount,
  [out]     PUSHORT GroupArray
);

Parámetros

[in] hProcess

Identificador del proceso.

Este identificador debe tener el derecho de acceso PROCESS_QUERY_INFORMATION o PROCESS_QUERY_LIMITED_INFORMATION. Para obtener más información, consulte Derechos de acceso y seguridad de procesos.

[in, out] GroupCount

En la entrada, especifica el número de elementos de la matriz GroupArray . En la salida, especifica el número de grupos de procesadores escritos en la matriz. Si la matriz es demasiado pequeña, se produce un error en la función con ERROR_INSUFFICIENT_BUFFER y establece el parámetro GroupCount en el número de elementos necesarios.

[out] GroupArray

Matriz de números de grupo de procesadores. Un número de grupo se incluye en la matriz si se asigna un subproceso en el proceso a un procesador del grupo.

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.

Si el valor de error es ERROR_INSUFFICIENT_BUFFER, el parámetro GroupCount contiene el tamaño de búfer necesario en el número de elementos.

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.

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 (incluya Windows.h en Windows Server 2008 Windows Server 2008 R2)
Library Kernel32.lib
Archivo DLL Kernel32.dll

Vea también

GetThreadGroupAffinity

Grupos de procesadores