Condividi tramite


Struttura TimeSample (timeprov.h)

Rappresenta un esempio di ora.

Sintassi

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;

Members

dwSize

Dimensioni della struttura, in byte.

dwRefid

Identificatore di riferimento per l'origine ora, in formato NTP (un indirizzo IP o una stringa ASCII a quattro caratteri che descrive l'origine hardware, ad esempio GPS o WWVB).

toOffset

Differenza tra gli orologi locali e remoti, in (10^-7)s.

toDelay

Ritardo totale del round trip, in (10^-7)s. Si tratta dei pacchetti di tempo trascorsi in transito dall'origine ora radice al client, incluso il ritardo radice. Per i provider NTP, questo significa ritardare il round trip per il peer, oltre al ritardo radice del peer. I provider hardware, questo valore è probabilmente zero.

tpDispersion

Errore di misurazione totale dell'offset dell'orologio, inclusa la dispersione radice, in (10^-7)s. Sono inclusi gli errori nella lettura dell'orologio locale, nell'incertezza nella frequenza di clock locale e nell'errore dei filtri. Per i provider NTP, ciò include la dispersione radice del peer.

nSysTickCount

Valore restituito da GetTimeSysInfo con TSI_TickCount.

nSysPhaseOffset

Valore restituito da GetTimeSysInfo con TSI_PhaseOffset.

nLeapFlags

Variabile che indica un secondo o una perdita di sincronizzazione imminente. Questo membro può essere uno dei valori seguenti.

Valore Significato
0
Nessuna modifica.
1
Aggiungi secondo bisestile.
2
Sottrae un secondo salto.
3
Non sincronizzato.

nStratum

Numero di hop di rete che separano il computer dall'origine radice. I provider di hardware devono restituire zero. I provider NTP devono restituire lo strato del peer che ha fornito l'esempio.

dwTSFlags

Informazioni sull'origine dell'ora.

Valore Significato
TSF_Authenticated
L'esempio è stato autenticato in modo crittografico.
TSF_Hardware
L'esempio proviene da un dispositivo hardware, ad esempio un GPS o un ricevitore radio.

wszUniqueName[256]

Nome che identifica in modo univoco l'origine dell'esempio. Per i provider di rete, il nome deve includere il protocollo e gli indirizzi IP. Per i dispositivi hardware, il nome deve includere il nome del dispositivo e la porta di comunicazione.

Requisiti

Requisito Valore
Client minimo supportato Windows XP [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Intestazione timeprov.h

Vedi anche

GetTimeSysInfoFunc

TpcGetSamplesArgs