Función QueryIdleProcessorCycleTime (realtimeapiset.h)

Recupera el tiempo de ciclo para el subproceso inactivo de cada procesador del sistema.

En un sistema con más de 64 procesadores, esta función recupera el tiempo de ciclo para el subproceso inactivo de cada procesador del grupo de procesadores al que se asigna el subproceso que realiza la llamada. Use la función QueryIdleProcessorCycleTimeEx para recuperar el tiempo de ciclo del subproceso inactivo en cada procesador lógico para un grupo de procesadores específico.

Sintaxis

BOOL QueryIdleProcessorCycleTime(
  [in, out] PULONG   BufferLength,
  [out]     PULONG64 ProcessorIdleCycleTime
);

Parámetros

[in, out] BufferLength

En la entrada, especifica el tamaño del búfer ProcessorIdleCycleTime , en bytes. Se espera que este búfer sea 8 veces el número de procesadores del grupo.

En la salida, especifica el número de elementos escritos en el búfer. Si el tamaño del búfer no es suficiente, se produce un error en la función y este parámetro recibe la longitud necesaria del búfer.

[out] ProcessorIdleCycleTime

Número de ciclos de reloj de CPU usados por cada subproceso inactivo. Este búfer debe ser 8 veces el número de procesadores del sistema en tamaño.

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, llame a GetLastError.

Comentarios

Para compilar una aplicación que use esta función, defina _WIN32_WINNT como 0x0600 o posterior.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	realtimeapiset.h (incluye Windows.h en Windows 7, Windows Server 2008 Windows Server 2008 R2)
Library	Kernel32.lib
Archivo DLL	Kernel32.dll

Vea también

Grupos de procesadores

QueryIdleProcessorCycleTimeEx

QueryProcessCycleTime

QueryThreadCycleTime