Compartilhar via

Função PdhGetCounterTimeBase (pdh.h)

  • Artigo

Retorna a base de tempo do contador especificado.

Sintaxe

PDH_FUNCTION PdhGetCounterTimeBase(
  [in]  PDH_HCOUNTER hCounter,
  [out] LONGLONG     *pTimeBase
);

Parâmetros

[in] hCounter

Manipule para o contador. A função PdhAddCounter retorna esse identificador.

[out] pTimeBase

Base de tempo que especifica o número de valores de desempenho que um contador amostra por segundo.

Valor retornado

Se a função for bem-sucedida, ela retornará ERROR_SUCCESS.

Se a função falhar, o valor retornado será um código de erro do sistema ou um código de erro PDH. Veja a seguir os valores possíveis.

Código de retorno Descrição
PDH_INVALID_ARGUMENT
 O contador especificado não usa uma base de tempo.
PDH_INVALID_HANDLE
 O identificador do contador não é válido.

Comentários

Se você usar a função PdhFormatFromRawValue para calcular um valor exibivel em vez de chamar a função PdhCalculateCounterFromRawValue , chame a função PdhGetCounterTimeBase para recuperar a base de tempo.

Cada contador que retorna dados de desempenho baseados em tempo tem uma base de tempo definida para ele. A base de tempo de um contador é o número de vezes que um contador amostra dados por segundo.

Requisitos

   
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho pdh.h
Biblioteca Pdh.lib
DLL Pdh.dll

Confira também

PdhFormatFromRawValue