Compartir a través de

Función GetProcessDefaultCpuSetMasks (processthreadsapi.h)

  • Artículo

Recupera la lista de conjuntos de CPU en el conjunto predeterminado del proceso establecido por SetProcessDefaultCpuSetMasks o SetProcessDefaultCpuSets.

Sintaxis

BOOL GetProcessDefaultCpuSetMasks(
  HANDLE          Process,
  PGROUP_AFFINITY CpuSetMasks,
  USHORT          CpuSetMaskCount,
  PUSHORT         RequiredMaskCount
);

Parámetros

Process

Especifica un identificador de proceso para el proceso que se va a consultar. Este identificador debe tener el derecho de acceso PROCESS_QUERY_LIMITED_INFORMATION . El valor devuelto por GetCurrentProcess también se puede especificar aquí.

CpuSetMasks

Especifica un búfer opcional para recuperar una lista de GROUP_AFFINITY estructuras que representan los conjuntos de CPU predeterminados del proceso.

CpuSetMaskCount

Especifica el tamaño de la matriz CpuSetMasks , en elementos .

RequiredMaskCount

Si la devolución es correcta, especifica el número de estructuras de afinidad escritas en la matriz. Si la matriz CpuSetMasks es demasiado pequeña, se produce un error en la función con ERROR_INSUFFICIENT_BUFFER y establece el parámetro RequiredMaskCount en el número de elementos necesarios. El número de elementos necesarios es siempre menor o igual que el número máximo de grupos devuelto por GetMaximumProcessorGroupCount.

Valor devuelto

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

Si se produce un error en la función, el valor devuelto es cero y la información de error extendida se puede recuperar llamando a GetLastError.

Si la matriz proporcionada es demasiado pequeña, el valor de error se ERROR_INSUFFICIENT_BUFFER y RequiredMaskCount se establece en el número de elementos necesarios.

Comentarios

Si no se establece ningún conjunto de CPU predeterminado para un proceso determinado, el parámetro RequiredMaskCount se establece en 0 y la función se realiza correctamente.

Esta función es análoga a GetProcessDefaultCpuSets, salvo que usa afinidades de grupo en lugar de identificadores de conjunto de CPU para representar una lista de conjuntos de CPU. Esto significa que los conjuntos de CPU predeterminados del proceso se asignan a sus procesadores principales y esos procesadores se recuperan en la lista resultante de afinidades de grupo.

Requisitos

   
Cliente mínimo compatible Windows 11
Servidor mínimo compatible Windows Server 2022
Encabezado processthreadsapi.h
Archivo DLL kernel32.dll