Compartir a través de

Función GetSystemCpuSetInformation (processthreadsapi.h)

  • Artículo

Permite a una aplicación consultar los conjuntos de CPU disponibles en el sistema y su estado actual.

Sintaxis

BOOL GetSystemCpuSetInformation(
  PSYSTEM_CPU_SET_INFORMATION Information,
  ULONG                       BufferLength,
  PULONG                      ReturnedLength,
  HANDLE                      Process,
  ULONG                       Flags
);

Parámetros

Information

Puntero a una estructura de SYSTEM_CPU_SET_INFORMATION que recibe los datos del conjunto de CPU. Pase NULL con una longitud de búfer de 0 para determinar el tamaño de búfer necesario.

BufferLength

Longitud, en bytes, del búfer de salida pasado como argumento Information.

ReturnedLength

Longitud, en bytes, de los datos válidos en el búfer de salida si el búfer es lo suficientemente grande o el tamaño necesario del búfer de salida. Si no existen conjuntos de CPU, este valor será 0.

Process

Identificador opcional de un proceso. Este proceso se usa para determinar el valor de la marca AllocatedToTargetProcess en la estructura SYSTEM_CPU_SET_INFORMATION. Si se asigna un conjunto de CPU al proceso especificado, se establece la marca . De lo contrario, está claro. Este identificador debe tener el derecho de acceso PROCESS_QUERY_LIMITED_INFORMATION. El valor devuelto por GetCurrentProcess también se puede especificar aquí.

Flags

Reservado, debe ser 0.

Valor devuelto

Si la API se realiza correctamente, devuelve TRUE. Si se produce un error, el motivo del error está disponible a través de GetLastError. Si el búfer de información era NULL o no era lo suficientemente grande, se devuelve el código de error ERROR_INSUFFICIENT_BUFFER. Esta API no puede producir un error cuando se pasan parámetros válidos y un búfer lo suficientemente grande como para contener todos los datos devueltos.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 10
Servidor mínimo compatible WIndows Server 2016
Encabezado processthreadsapi.h