Función GetThreadTimes (processthreadsapi.h)
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 |