Função KeConvertPerformanceCounterToAuxiliaryCounter (wdm.h)

Artigo
02/07/2025

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.

Valor de retorno

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 atual do contador de desempenho.
STATUS_UNSUCCESSFUL	A rotina não pode converter o valor especificado com precisão aceitável.

Observações

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 ou recuperação do sistema 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
de cliente com suporte mínimo	Disponível a partir do Windows 10.
da Plataforma de Destino	Universal
cabeçalho	wdm.h
biblioteca	Ntoskrnl.lib
de DLL	Hal.dll
IRQL	Qualquer nível

Consulte também

KeConvertAuxiliaryCounterToPerformanceCounter

Compartilhar via