Structure TimeSample (timeprov.h)

Article
08/26/2023

Représente un exemple de temps.

Syntaxe

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;

Membres

dwSize

Taille de la structure, en octets.

dwRefid

Identificateur de référence pour la source de temps, au format NTP (une adresse IP ou une chaîne ASCII de quatre caractères qui décrit la source matérielle, par exemple GPS ou WWVB).

toOffset

Différence entre les horloges locales et distantes, dans (10^-7)s.

toDelay

Délai d’aller-retour total, en (10^-7)s. Il s’agit du temps passé en transit des paquets de la source d’heure racine vers le client, y compris le délai racine. Pour les fournisseurs NTP, cela signifie un délai d’aller-retour vers l’homologue, plus le délai racine de l’homologue. Pour les fournisseurs de matériel, cette valeur est probablement égale à zéro.

tpDispersion

Erreur de mesure totale du décalage d’horloge, y compris la dispersion racine, dans (10^-7) s. Cela inclut les erreurs de lecture de l’horloge locale, l’incertitude dans la fréquence d’horloge locale et l’erreur des filtres. Pour les fournisseurs NTP, cela inclut la dispersion racine de l’homologue.

nSysTickCount

Valeur retournée par GetTimeSysInfo avec TSI_TickCount.

nSysPhaseOffset

Valeur retournée par GetTimeSysInfo avec TSI_PhaseOffset.

nLeapFlags

Variable qui indique une seconde intermédiaire imminente ou une perte de synchronisation. Ce membre peut être l’une des valeurs suivantes.

Valeur	Signification
0	Aucune modification.
1	Ajoutez une seconde de seconde.
2	Soustraire la seconde.
3	Non synchronisé.

nStratum

Nombre de tronçons réseau séparant cet ordinateur de la source racine. Les fournisseurs de matériel doivent retourner zéro. Les fournisseurs NTP doivent retourner la strate de l’homologue qui a fourni l’exemple.

dwTSFlags

Informations sur la source de temps.

Valeur	Signification
TSF_Authenticated	L’exemple a été authentifié par chiffrement.
TSF_Hardware	L’exemple provient d’un appareil matériel tel qu’un GPS ou un récepteur radio.

wszUniqueName[256]

Nom qui identifie de manière unique la source de l’exemple. Pour les fournisseurs réseau, le nom doit inclure le protocole et les adresses IP. Pour les appareils matériels, le nom doit inclure le nom de l’appareil et le port de communication.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
En-tête	timeprov.h

Voir aussi

GetTimeSysInfoFunc

TpcGetSamplesArgs

Partager via