Função QueryInterruptTime (realtimeapiset.h)

Obtém a contagem atual de tempo de interrupção. Para uma contagem mais precisa, use queryInterruptTimePrecise.

Sintaxe

void QueryInterruptTime(
  [out] PULONGLONG lpInterruptTime
);

Parâmetros

[out] lpInterruptTime

Um ponteiro para um ULONGLONG no qual receber a contagem de tempo de interrupção em unidades de tempo do sistema de 100 nanossegundos. Divida por dez milhões, ou 1e7, para obter segundos (há 1e9 nanossegundos em um segundo, então há 1e7 100 nanossegundos em um segundo).

Valor de retorno

Nenhum

Observações

A contagem de tempo de interrupção começa em zero quando o sistema é iniciado e incrementado em cada interrupção de relógio pelo comprimento de um tique de relógio. O comprimento exato de um relógio depende do hardware subjacente e pode variar entre os sistemas.

Ao contrário do tempo do sistema, a contagem de tempo de interrupção não está sujeita a ajustes por parte dos usuários ou do serviço de tempo do Windows. Os aplicativos podem usar a contagem de tempo de interrupção para medir durações mais finas do que são possíveis com o tempo do sistema. Os aplicativos que exigem maior precisão do que a contagem de tempo de interrupção devem usar um de temporizador de alta resolução. Use a função QueryPerformanceFrequency para recuperar a frequência do temporizador de alta resolução e a função queryPerformanceCounter para recuperar o valor do contador.

A resolução de temporizador definida pelas funções timeBeginPeriod e timeEndPeriod afeta a resolução da função QueryInterruptTime. No entanto, não é recomendável aumentar a resolução do temporizador porque ele pode reduzir o desempenho geral do sistema e aumentar o consumo de energia do sistema, impedindo que o processador insira estados de economia de energia. Em vez disso, os aplicativos devem usar um temporizador de alta resolução.

Observação A função QueryInterruptTime produz resultados diferentes em builds de depuração ("verificado") do Windows, pois a contagem de tempo de interrupção e a contagem de tiques são avançadas por aproximadamente 49 dias. Isso ajuda a identificar bugs que podem não ocorrer até que o sistema esteja em execução há muito tempo.

 

Para compilar um aplicativo que usa essa função, defina _WIN32_WINNT como 0x0601 ou posterior. Para obter mais informações, consulte Usando os cabeçalhos do Windows.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 10 [aplicativos da área de trabalho | Aplicativos UWP]
servidor com suporte mínimo	Windows Server 2016 [aplicativos da área de trabalho | Aplicativos UWP]
da Plataforma de Destino	Windows
cabeçalho	realtimeapiset.h
biblioteca	Mincore.lib
de DLL	Kernel32.dll

Consulte também

de tempo de interrupção

queryInterruptTimePrecise

queryUnbiasedInterruptTime

QueryUnbiasedInterruptTimePrecise

de estados de energia do sistema

do Windows Time