Fonction de rappel GetTimeSysInfoFunc (timeprov.h)

Article
08/26/2023

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

Partager via