Share via

Función QueryThreadCycleTime (realtimeapiset.h)

  • Artículo

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

Vea también

QueryIdleProcessorCycleTime

QueryProcessCycleTime