Función GetSystemCpuSetInformation

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

Sintaxis

BOOL WINAPI GetSystemCpuSetInformation(
  _Out_opt_  PSYSTEM_CPU_SET_INFORMATION  Information,
  _In_       ULONG                        BufferLength,
  _Out_      PULONG                       ReturnedLength,
  _In_opt_   HANDLE                       Process,
  _Reserved_ ULONG                        Flags
);

Parámetros

Información [out, opcional]

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 [in]

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

ReturnedLength [out]

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

Proceso [in, opcional]

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 puede especificarse aquí.

Marcas

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 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2016 [aplicaciones de escritorio | Aplicaciones para UWP]
Encabezado	Processthreadsapi.h
Biblioteca	Windows.h
Archivo DLL	Kernel32.dll