Lire en anglais

Partager via


Fonction de rappel GetTimeSysInfoFunc (timeprov.h)

Récupère les informations d’état de l’heure système.

Syntaxe

GetTimeSysInfoFunc Gettimesysinfofunc;

HRESULT Gettimesysinfofunc(
  [in]  TimeSysInfo eInfo,
  [out] void *pvInfo
)
{...}

Paramètres

[in] eInfo

Informations d’état demandées. Ce paramètre peut prendre les valeurs suivantes.

Valeur Signification
TSI_ClockPrecision
Le paramètre pvInfo est une valeur de __int32 signée qui spécifie la précision de l’horloge, en secondes log2.
TSI_ClockTickSize
Le paramètre pvInfo est une valeur de __int64 non signée qui spécifie la taille de la graduation de l’horloge, en (10^-7) secondes.
TSI_CurrentTime
Le paramètre pvInfo est une valeur de __int64 non signée qui spécifie l’heure actuelle, dans (10^-7) intervalles de seconde qui se sont écoulés depuis le 1er janvier 1601 (UTC) à 12 :00.
TSI_LastSyncTime
Le paramètre pvInfo est une valeur de __int64 non signée qui spécifie l’heure de la dernière synchronisation, dans des intervalles de (10^-7) secondes qui se sont écoulés depuis le 1er janvier 1601 en temps universel coordonné (UTC) à 12 :00.
TSI_LeapFlags
Le paramètre pvInfo est une valeur BYTE qui indique une seconde intermédiaire imminente ou une perte de synchronisation. Les valeurs suivantes sont définies :
0 - Aucune modification
1 - Ajouter une seconde de saut
2 - Soustraire la seconde de saut
3 - Non synchronisé
TSI_PhaseOffset
Le paramètre pvInfo est une valeur de __int64 signée qui spécifie le décalage de phase utilisé pour ajuster l’horloge, en secondes.
TSI_PollInterval
Le paramètre pvInfo est une valeur de __int32 signée qui spécifie l’intervalle d’interrogation, en secondes log2.
TSI_ReferenceIdentifier
Le paramètre pvInfo est une valeur DWORD qui spécifie l’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 (Global Positioning System) ou WWVB).
TSI_RootDelay
Le paramètre pvInfo est une valeur de __int64 signée qui spécifie le délai racine, en (10^-7) secondes.
TSI_RootDispersion
Le paramètre pvInfo est une valeur de __int64 non signée qui spécifie, la dispersion racine, en (10^-7) secondes.
TSI_Stratum
Le paramètre pvInfo est une valeur BYTE qui spécifie le nombre de tronçons réseau qui séparent 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.
TSI_TickCount
Le paramètre pvInfo est une valeur de __int64 non signée qui spécifie le nombre de graduations (nombre de millisecondes depuis le démarrage du système). Cette valeur finira par être encapsulé. Elle ne doit donc être utilisée que pour comparer des intervalles courts.
TSI_TSFlags
Le paramètre pvInfo est une valeur DWORD qui spécifie l’un des indicateurs de source de temps suivants :
TSF_Authenticated
TSF_Hardware
TSF_IPv6

[out] pvInfo

Pointeur vers une mémoire tampon qui reçoit ces informations d’état. Le format de ces données dépend de la valeur d’eInfo.

Valeur retournée

Si la fonction réussit, la valeur de retour est S_OK. Sinon, la valeur de retour est l’un des codes d’erreur définis dans WinError.h.

Remarques

Pour garantir l’exactitude, le fournisseur de temps doit récupérer toutes les informations relatives au temps à l’aide de GetTimeSysInfoFunc. Notez que les valeurs de temps ne doivent pas être utilisées directement dans un paquet NTP. Elles sont exprimées par rapport au 1er janvier 1601 à 12 h, tandis que NTP spécifie que les valeurs temporelles sont exprimées par rapport à 12 h 00 le 1er janvier 1900.

La fonction TimeProvOpen retourne un pointeur vers cette fonction.

Exemples

Pour obtenir un exemple, consultez Exemple de fournisseur de temps.

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]
Plateforme cible Windows
En-tête timeprov.h