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.

Requisitos

Consulte também

de tempo de interrupção

queryInterruptTimePrecise

queryUnbiasedInterruptTime

QueryUnbiasedInterruptTimePrecise

de estados de energia do sistema

do Windows Time