Méthode IMFClockStateSink::OnClockStart (mfidl.h)

Appelé au démarrage de l’horloge de la présentation.

Syntaxe

HRESULT OnClockStart(
  [in] MFTIME   hnsSystemTime,
  [in] LONGLONG llClockStartOffset
);

Paramètres

[in] hnsSystemTime

Heure système au démarrage de l’horloge, en unités de 100 nanosecondes.

[in] llClockStartOffset

Nouvelle heure de début de l’horloge, en unités de 100 nanosecondes. Ce paramètre peut également être égal PRESENTATION_CURRENT_POSITION, indiquant que l’horloge a démarré ou redémarré à partir de sa position actuelle.

Valeur retournée

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Notes

Cette méthode est appelée lorsque la méthode IMFPresentationClock::Start de l’horloge de présentation est appelée, avec l’exception suivante : Si l’horloge est suspendue et Start est appelée avec la valeur PRESENTATION_CURRENT_POSITION, IMFClockStateSink::OnClockRestart est appelé au lieu de OnClockStart.

L’horloge avertit la source d’heure de présentation en appelant la méthode OnClockStart de la source de temps. Cet appel se produit de manière synchrone dans la méthode Start . Si la source d’heure retourne une erreur à partir d’OnClockStart, la méthode Start de l’horloge de présentation renvoie une erreur et le changement d’état n’a pas lieu.

Pour tout objet qui n’est pas la source d’heure de présentation, la méthode OnClockStart est appelée de manière asynchrone, une fois le changement d’état terminé. Dans ce cas, la valeur de retour de cette méthode est ignorée.

La valeur indiquée dans llClockStartOffset correspond à l’heure de présentation au démarrage de l’horloge. Elle est donc relative au début de la présentation. Les récepteurs multimédias ne doivent pas afficher les données dont l’heure de présentation est antérieure à llClockStartOffSet. Si un exemple chevauche le décalage, c’est-à-dire si le décalage se situe entre les heures de début et d’arrêt de l’exemple, le récepteur doit soit supprimer l’exemple de sorte que seules les données après le rendu de llClockStartOffset soient rendues, soit simplement supprimer l’exemple.

Spécifications

Voir aussi

IMFClockStateSink

MFTIME

Horloge de présentation