Función GetProcessGroupAffinity (processtopologyapi.h)
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 |