Función QueryThreadCycleTime (realtimeapiset.h)
Recupera el tiempo de ciclo del subproceso especificado.
Sintaxis
BOOL QueryThreadCycleTime(
[in] HANDLE ThreadHandle,
[out] PULONG64 CycleTime
);
Parámetros
[in] ThreadHandle
Identificador del subproceso. El identificador debe tener el derecho de acceso PROCESS_QUERY_INFORMATION o PROCESS_QUERY_LIMITED_INFORMATION. Para obtener más información, consulte Derechos de acceso y seguridad de procesos.
[out] CycleTime
Número de ciclos de reloj de CPU utilizados por el subproceso. Este valor incluye ciclos invertidos tanto en modo de usuario como en modo kernel.
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 enumerar los subprocesos del proceso, use las funciones
No intente convertir los ciclos de reloj de CPU devueltos por QueryThreadCycleTime a tiempo transcurrido. Esta función usa los servicios de temporizador proporcionados por la CPU, que pueden variar en la implementación. Por ejemplo, algunas CPU variarán la frecuencia del temporizador al cambiar la frecuencia con la que se ejecuta la CPU y otras las dejará a una velocidad fija. El comportamiento de cada CPU se describe en la documentación proporcionada por el proveedor de CPU.
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 |