Partager via


IKsReferenceClock ::GetCorrelatedTime, méthode (ks.h)

La méthode IKsReferenceClock ::GetCorrelatedTime interroge l’horloge de référence associée pour l’heure de flux actuelle et acquiert l’heure système corrélée.

Syntaxe

LONGLONG GetCorrelatedTime(
  [out] PLONGLONG SystemTime
);

Paramètres

[out] SystemTime

Pointeur vers une variable de type LONGLONG qui reçoit l’heure système actuelle en unités de 100 nanosecondes.

Valeur retournée

La méthode IKsReferenceClock ::GetCorrelatedTime retourne l’heure de flux, spécifiée par défaut en unités de 100 nanosecondes. L’heure système corrélée est retournée dans SystemTime.

Remarques

Utilisez cette méthode pour déterminer la différence entre l’heure de flux et l’heure système. IKsReferenceClock ::GetCorrelatedTime retourne les heures que les deux horloges affichent au même moment.

Pour obtenir les résultats les plus précis, appelez cette méthode uniquement lorsque le flux est dans un état d’exécution (KSSTATE_RUN) et non pendant une transition d’état.

Vous devez utiliser cette méthode lors de l’obtention d’un horodatage à placer dans le membre PresentationTime de KSSTREAM_HEADER.

Pour plus d’informations, consultez Horloges AVStream.

AVStream utilise la propriété KSPROPERTY_CLOCK_CORRELATEDTIME pour récupérer l’heure corrélée.

Configuration requise

Condition requise Valeur
Plateforme cible Universal
En-tête ks.h (inclure Ks.h)

Voir aussi

KsPinGetReferenceClockInterface