Compartilhar via


GetThreadTimes

Windows Mobile SupportedWindows Embedded CE Supported

9/8/2008

Essa função obtém informações temporização sobre um segmento especificado.

Syntax

BOOL GetThreadTimes (
  HANDLE hThread,
  LPFILETIME lpCreationTime,
  LPFILETIME lpExitTime,
  LPFILETIME lpKernelTime,
  LPFILETIME lpUserTime
);

Parameters

  • hThread
    [no] Abrir identificador que especifica o segmento cujas informações temporização são procuradas.

    Esse identificador deve ser criada com acessar THREAD_QUERY_INFORMATION.

  • lpCreationTime
    [out] Ponteiro longo para uma estrutura FILETIME que recebe o hora da criação do segmento.
  • lpExitTime
    [out] Ponteiro longo para um FILETIME estrutura que recebe o tempo sair do segmento.

    Se o segmento não foi encerrado, o de conteúdo dessa estrutura é indefinido.

  • lpKernelTime
    [out] Ponteiro longo para um FILETIME estrutura que recebe a quantidade de tempo de segmento executado no modo kernel.
  • lpUserTime
    [out] Ponteiro para um FILETIME estrutura que recebe a quantidade de tempo de segmento executado em modo de usuário.

Return Value

Nonzero indica sucesso. Zero indica falha. Para informações de erro estendidas get, chamar GetLastError.

Remarks

Todos os horários são expressos usando FILETIME Estruturas dados. Tal uma estrutura contém dois 32 - bit valores que combinar a forma de 64-bit contagem de unidades tempo 100-nanosecond.

Tempos de criação e sair de segmento são pontos no tempo expresso como a quantidade de tempo decorrido desde a meia-noite no January 1, 1601 em Greenwich, England.

Horários modo de usuário e modo kernel segmento são quantidades de tempo. De exemplo, se um segmento gasta um segundo no modo kernel, essa função preenche a FILETIME estrutura especificada por lpKernelTime Com um 64-bit valor de Ten million. O número de unidades 100-nanosecond que está em um segundo.

O seguinte suporte restrições são definidas para GetThreadTimes Para Windows CE 2.10 através de 2.12:

  • O lpCreationTime, lpExitTime, e lpKernelTime Parâmetros não são com suporte. Elas sempre são retornadas como zero.
  • O lpUserTime parâmetro informa o tempo total de um segmento foi execução. Não há nenhuma diferença entre os modos de usuário e kernel.
  • O lpUserTime parâmetro não é válido quando o segmento é encerrado.

Requirements

Header winbase.h
Library coredll.lib
Windows Embedded CE Windows CE 2.10 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

Process and Thread Functions
FILETIME