Estrutura TimeSample (timeprov.h)

Representa um exemplo de tempo.

Sintaxe

typedef struct TimeSample {
  DWORD            dwSize;
  DWORD            dwRefid;
  signed __int64   toOffset;
  signed __int64   toDelay;
  unsigned __int64 tpDispersion;
  unsigned __int64 nSysTickCount;
  signed __int64   nSysPhaseOffset;
  BYTE             nLeapFlags;
  BYTE             nStratum;
  DWORD            dwTSFlags;
  WCHAR            wszUniqueName[256];
} TimeSample;

Membros

dwSize

O tamanho da estrutura em bytes.

dwRefid

Um identificador de referência para a fonte de tempo, no formato NTP (um endereço IP ou uma cadeia de caracteres ASCII de quatro caracteres que descreve a origem do hardware, como GPS ou WWVB).

toOffset

A diferença entre relógios locais e remotos, em (10^-7)s.

toDelay

O atraso total da ida e volta, em (10^-7)s. Esse é o tempo gasto pelos pacotes em trânsito da fonte de tempo raiz para o cliente, incluindo o atraso raiz. Para provedores NTP, isso significa atraso de ida e volta para o par, além do atraso raiz do par. Os provedores de hardware, esse valor provavelmente é zero.

tpDispersion

O erro de medição total do deslocamento do relógio, incluindo a dispersão raiz, em (10^-7)s. Isso inclui erros ao ler o relógio local, a incerteza na frequência do relógio local e o erro dos filtros. Para provedores NTP, isso inclui a dispersão raiz do par.

nSysTickCount

O valor retornado por GetTimeSysInfo com TSI_TickCount.

nSysPhaseOffset

O valor retornado por GetTimeSysInfo com TSI_PhaseOffset.

nLeapFlags

Uma variável que indica um segundo bissexto iminente ou perda de sincronização. Esse membro pode ser um dos valores a seguir.

Valor	Significado
0	Nenhuma alteração.
1	Adicione o segundo salto.
2	Subtrair o segundo salto.
3	Não sincronizado.

nStratum

O número de saltos de rede que separam esse computador da origem raiz. Os provedores de hardware devem retornar zero. Os provedores NTP devem retornar o estrato do par que forneceu o exemplo.

dwTSFlags

As informações sobre a fonte de tempo.

Valor	Significado
TSF_Authenticated	O exemplo foi autenticado criptograficamente.
TSF_Hardware	O exemplo é de um dispositivo de hardware, como um GPS ou um receptor de rádio.

wszUniqueName[256]

O nome que identifica exclusivamente a origem do exemplo. Para provedores de rede, o nome deve incluir o protocolo e os endereços IP. Para dispositivos de hardware, o nome deve incluir o nome do dispositivo e a porta de comunicação.

Requisitos

Requisito	Valor
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]
Cabeçalho	timeprov.h

Confira também

GetTimeSysInfoFunc

TpcGetSamplesArgs