Función QueryIdleProcessorCycleTime (realtimeapiset.h)
Recupera el tiempo de ciclo del subproceso inactivo de cada procesador del sistema.
En un sistema con más de 64 procesadores, esta función recupera el tiempo de ciclo del 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 de 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 en el tamaño del sistema.
Valor devuelto
Si la función se ejecuta correctamente, el valor devuelto es distinto de cero.
Si se produce un error en la función, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.
Observaciones
Para compilar una aplicación que use esta función, defina _WIN32_WINNT como 0x0600 o posterior.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Windows Vista [solo aplicaciones de escritorio] |
| servidor mínimo admitido | Windows Server 2008 [solo aplicaciones de escritorio] |
| de la plataforma de destino de |
Windows |
| encabezado de |
realtimeapiset.h (incluya Windows.h en Windows 7, Windows Server 2008 Windows Server 2008 R2) |
| biblioteca de |
Mincore.lib |
| DLL de |
Kernel32.dll |
Consulte también
grupos de procesadores de