Função KeConvertPerformanceCounterToAuxiliaryCounter (wdm.h)

  • Artigo

A rotina KeConvertPerformanceCounterToAuxiliaryCounter converte o valor do contador de desempenho especificado em um valor de contador auxiliar.

Sintaxe

NTSTATUS KeConvertPerformanceCounterToAuxiliaryCounter(
  [in]            ULONG64  PerformanceCounterValue,
  [out]           PULONG64 AuxiliaryCounterValue,
  [out, optional] PULONG64 ConversionError
);

Parâmetros

[in] PerformanceCounterValue

O valor do contador de desempenho a ser convertido.

[out] AuxiliaryCounterValue

Um ponteiro para a variável que contém o valor do contador auxiliar convertido.

[out, optional] ConversionError

Um ponteiro para uma variável que contém o erro de conversão estimado em unidades de nanossegundos.

Retornar valor

KeConvertPerformanceCounterToAuxiliaryCounter pode retornar um dos seguintes:

Código de retorno Descrição
STATUS_SUCCESS
 A conversão foi bem-sucedida.
STATUS_NOT_SUPPORTED
 Não há suporte para contador auxiliar.
STATUS_INVALID_PARAMETER
O valor PerformanceCounterValue não é válido. Por exemplo, o valor é anterior à última inicialização/recuperação do sistema ou está fora do intervalo +/- 10s em comparação com o valor do contador de desempenho atual.
STATUS_UNSUCCESSFUL
A rotina não pode converter o valor especificado com precisão aceitável.

Comentários

Verifique se o valor do contador de desempenho especificado é:

  • Dentro de +/- 10s em comparação com o valor de leitura do contador de desempenho atual.
  • Não anterior ao valor do contador de desempenho registrado na última inicialização do sistema ou recuperação do estado S3/S4.
O valor ConversionError é a diferença, em nanossegundos, entre o valor calculado esperado e o valor calculado real para o contador auxiliar. Se o valor ConversionError for maior que o valor esperado (determinado por você), chame a rotina novamente.

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível a partir do Windows 10.
Plataforma de Destino Universal
Cabeçalho wdm.h
Biblioteca Ntoskrnl.lib
DLL Hal.dll
IRQL Qualquer nível

Confira também

KeConvertAuxiliaryCounterToPerformanceCounter