Función GetThreadSelectedCpuSetMasks (processthreadsapi.h)

Devuelve la asignación explícita del conjunto de CPU del subproceso especificado, si se estableció alguna asignación mediante SetThreadSelectedCpuSetMasks o SetThreadSelectedCpuSets.

Sintaxis

BOOL GetThreadSelectedCpuSetMasks(
  HANDLE          Thread,
  PGROUP_AFFINITY CpuSetMasks,
  USHORT          CpuSetMaskCount,
  PUSHORT         RequiredMaskCount
);

Parámetros

Thread

Especifica el subproceso para el que se va a consultar los conjuntos de CPU seleccionados. 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 estructuras de GROUP_AFFINITY que representan los conjuntos de CPU seleccionados para el subproceso.

CpuSetMaskCount

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

RequiredMaskCount

Si la devolución se realiza correctamente, especifica el número de estructuras de afinidad escritas 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 RequiredMaskCount en el número de elementos necesarios. El número de elementos necesarios siempre es 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 es ERROR_INSUFFICIENT_BUFFER y RequiredMaskCount se establece en el número de elementos necesarios.

Comentarios

Si no se establece ninguna asignación explícita, RequiredMaskCount se establece en 0 y la función se realiza correctamente.

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

Requisitos

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