Función GetThreadTimes (processthreadsapi.h)

Artículo
08/25/2023

Recupera información de tiempo para el subproceso especificado.

Sintaxis

BOOL GetThreadTimes(
  [in]  HANDLE     hThread,
  [out] LPFILETIME lpCreationTime,
  [out] LPFILETIME lpExitTime,
  [out] LPFILETIME lpKernelTime,
  [out] LPFILETIME lpUserTime
);

Parámetros

[in] hThread

Identificador del subproceso cuya información de tiempo se busca. El identificador debe tener el derecho de acceso THREAD_QUERY_INFORMATION o THREAD_QUERY_LIMITED_INFORMATION . Para obtener más información, consulte Derechos de acceso y seguridad de subprocesos.

Windows Server 2003 y Windows XP: El identificador debe tener el derecho de acceso THREAD_QUERY_INFORMATION.

[out] lpCreationTime

Puntero a una estructura FILETIME que recibe la hora de creación del subproceso.

[out] lpExitTime

Puntero a una estructura FILETIME que recibe la hora de salida del subproceso. Si el subproceso no ha salido, el contenido de esta estructura no está definido.

[out] lpKernelTime

Puntero a una estructura FILETIME que recibe la cantidad de tiempo que el subproceso se ha ejecutado en modo kernel.

[out] lpUserTime

Puntero a una estructura FILETIME que recibe la cantidad de tiempo que el subproceso se ha ejecutado en modo de usuario.

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

Todas las veces se expresan mediante estructuras de datos FILETIME . Esta estructura contiene dos valores de 32 bits que se combinan para formar un recuento de 64 bits de unidades de tiempo de 100 nanosegundos.

Los tiempos de creación y salida de subprocesos son puntos en el tiempo expresados como la cantidad de tiempo transcurrido desde la medianoche del 1 de enero de 1601 en Greenwich, Inglaterra. Hay varias funciones que una aplicación puede usar para convertir dichos valores en formularios más generales útiles; vea Funciones de hora.

El modo de kernel de subproceso y las horas del modo de usuario son cantidades de tiempo. Por ejemplo, si un subproceso ha gastado un segundo en modo kernel, esta función rellenará la estructura FILETIME especificada por lpKernelTime con un valor de 64 bits de diez millones. Es el número de unidades de 100 nanosegundos en un segundo.

Para recuperar el número de ciclos de reloj de CPU usados por los subprocesos, use la función QueryThreadCycleTime .

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [aplicaciones de escritorio \| aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2003 [aplicaciones de escritorio \| aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	processthreadsapi.h (incluya Windows.h en Windows Server 2003, Windows Vista, Windows 7, Windows Server 2008 Windows Server 2008 R2)
Library	Kernel32.lib
Archivo DLL	Kernel32.dll