Compartilhar via


Função NtQueryPerformanceCounter

[Essa função não tem suporte e não deve ser usada. Use as funções QueryPerformanceCounter e QueryPerformanceFrequency em vez disso.]

Retorna o valor atual de um contador de desempenho e, opcionalmente, a frequência do contador de desempenho.

Sintaxe

NTSTATUS NtQueryPerformanceCounter(
  _Out_     PLARGE_INTEGER PerformanceCounter,
  _Out_opt_ PLARGE_INTEGER PerformanceFrequency
);

Parâmetros

PerformanceCounter [out]

O endereço de uma variável para receber o valor atual do contador de desempenho.

PerformanceFrequency [out, opcional]

O endereço de uma variável para receber a frequência do contador de desempenho.

Valor retornado

Se a função for bem-sucedida, ela retornará o código NTSTATUSSTATUS_SUCCESS; caso contrário, ele retorna um código de erro, como STATUS_ACCESS_VIOLATION.

Comentários

Nenhum arquivo de cabeçalho está disponível para NtQueryPerformanceCounter. Você deve usar as funções alternativas nomeadas acima, embora também possa usar as funções LoadLibrary e GetProcAddress para vincular dinamicamente a Ntdll.dll.

A frequência de desempenho é a frequência do contador de desempenho em hertz, especificamente em contagens por segundo. Esse valor depende da implementação. Se a implementação não tiver hardware para dar suporte ao tempo de desempenho, o valor retornado será 0.

Requisitos

Requisito Valor
DLL
Ntdll.dll

Confira também

Queryperformancecounter

QueryPerformanceFrequency