Função QueryThreadCycleTime (realtimeapiset.h)
Recupera o tempo de ciclo do thread especificado.
Sintaxe
BOOL QueryThreadCycleTime(
[in] HANDLE ThreadHandle,
[out] PULONG64 CycleTime
);
Parâmetros
[in] ThreadHandle
Um identificador para o thread. O identificador deve ter o acesso PROCESS_QUERY_INFORMATION ou PROCESS_QUERY_LIMITED_INFORMATION direito. Para obter mais informações, consulte Process Security and Access Rights.
[out] CycleTime
O número de ciclos de relógio de CPU usados pelo thread. Esse valor inclui ciclos gastos no modo de usuário e no modo kernel.
Valor de retorno
Se a função for bem-sucedida, o valor retornado não será zero.
Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.
Observações
Para enumerar os threads do processo, use as funções Thread32First e Thread32Next. Para obter a alça de thread de um identificador de thread, use a função OpenThread.
Não tente converter os ciclos de relógio da CPU retornados por QueryThreadCycleTime em tempo decorrido. Essa função usa serviços de temporizador fornecidos pela CPU, que podem variar na implementação. Por exemplo, algumas CPUs variarão a frequência do temporizador ao alterar a frequência em que a CPU é executada e outras a deixarão a uma taxa fixa. O comportamento de cada CPU é descrito na documentação fornecida pelo fornecedor da CPU.
Para compilar um aplicativo que usa essa função, defina _WIN32_WINNT como 0x0600 ou posterior.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows Vista [somente aplicativos da área de trabalho] |
| servidor com suporte mínimo | Windows Server 2008 [somente aplicativos da área de trabalho] |
| da Plataforma de Destino |
Windows |
| cabeçalho | realtimeapiset.h (inclua Windows.h no Windows 7, Windows Server 2008 Windows Server 2008 R2) |
| biblioteca | Mincore.lib |
| de DLL |
Kernel32.dll |