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 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 enumerar los subprocesos del proceso, use las funciones Thread32First y Thread32Next . Para obtener el identificador de subproceso de un identificador de subproceso, use la función OpenThread .
No intente convertir los ciclos de reloj de CPU devueltos por QueryThreadCycleTime al 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 lo dejarán 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 usa 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 |