Função ConvertPerformanceCounterToAuxiliaryCounter (realtimeapiset.h)

Artigo
03/01/2024

Converte o valor do contador de desempenho especificado no valor do contador auxiliar correspondente; opcionalmente fornece o erro de conversão estimado em nanossegundos devido a latências e descompasso máximo possível.

Sintaxe

HRESULT ConvertPerformanceCounterToAuxiliaryCounter(
  [in]            ULONGLONG  ullPerformanceCounterValue,
  [out]           PULONGLONG lpAuxiliaryCounterValue,
  [out, optional] PULONGLONG lpConversionError
);

Parâmetros

[in] ullPerformanceCounterValue

O valor do contador de desempenho a ser convertido.

[out] lpAuxiliaryCounterValue

Em caso de êxito, contém o valor do contador auxiliar convertido. Será indefinido se a função falhar.

[out, optional] lpConversionError

Em caso de êxito, contém o erro de conversão estimado, em nanossegundos. Será indefinido se a função falhar.

Retornar valor

Retorna S_OK se a conversão for bem-sucedida; caso contrário, retorna outro HRESULT especificando o erro.

Valor retornado	Descrição
S_OK	A função foi bem-sucedida.
E_NOTIMPL	Não há suporte para o contador auxiliar.
E_BOUNDS	O valor a ser convertido está fora do intervalo permitido (+/- 10 segundos a partir de quando o chamado ocorreu).
E_BOUNDS	O valor a ser convertido é antes da última inicialização do sistema ou da transição S3/S4.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 10, versão 1703 [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

Share via