Função QueryInterruptTime (realtimeapiset.h)

Artigo
08/25/2023

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).

Retornar valor

Nenhum

Comentários

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 tique de 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 horário do Windows. Os aplicativos podem usar a contagem de tempo de interrupção para medir durações mais finas do que as 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 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 do 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 entre em estados de economia de energia. Em vez disso, os aplicativos devem usar um temporizador de alta resolução.

Nota A função QueryInterruptTime produz resultados diferentes em builds de depuração ("verificados") do Windows, pois a contagem de tempo de interrupção e a contagem de tiques são avançadas em aproximadamente 49 dias. Isso ajuda a identificar bugs que podem não ocorrer até que o sistema esteja em execução há muito tempo. O build verificado está disponível para assinantes do MSDN por meio do site do MSDN (Microsoft Developer Network ).

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
Cliente mínimo com suporte	Windows 10 [aplicativos da área de trabalho \| Aplicativos UWP]
Servidor mínimo com suporte	Windows Server 2016 [aplicativos da área de trabalho \| Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	realtimeapiset.h
Biblioteca	Mincore.lib
DLL	Kernel32.dll