Méthode IMFPresentationClock ::Start (mfidl.h)

  • Article

Démarre l’horloge de la présentation.

Syntaxe

HRESULT Start(
  [in] LONGLONG llClockStartOffset
);

Paramètres

[in] llClockStartOffset

Heure de début initiale, en unités de 100 nanosecondes. Au moment où la méthode Start est appelée, la méthode IMFPresentationClock ::GetTime de l’horloge retourne cette valeur, et l’heure d’horloge s’incrémente à partir de là. Si la valeur est PRESENTATION_CURRENT_POSITION, l’horloge commence à sa position actuelle. Utilisez cette valeur si l’horloge est suspendue et que vous souhaitez la redémarrer à partir de la même position.

Valeur retournée

Cette méthode retourne un code HRESULT. Les valeurs possibles sont notamment celles figurant dans le tableau suivant.

Code de retour Description
S_OK
 S_OK
MF_E_CLOCK_NO_TIME_SOURCE
 Aucune source d’heure n’a été définie sur cette horloge.

Remarques

Cette méthode est valide dans tous les états (arrêté, suspendu ou en cours d’exécution).

Si l’horloge est suspendue et redémarrée à partir de la même position (llClockStartOffset est PRESENTATION_CURRENT_POSITION), l’horloge de présentation envoie une notification IMFClockStateSink ::OnClockRestart . Sinon, l’horloge envoie une notification IMFClockStateSink ::OnClockStart .

L’horloge de présentation lance le changement d’état en appelant OnClockStart ou OnClockRestart sur la source d’heure de l’horloge. Cet appel est effectué de manière synchrone. En cas d’échec, le changement d’état ne se produit pas. Si l’appel réussit, l’état change et l’horloge avertit les autres abonnés à changement d’état en appelant leurs méthodes OnClockStart ou OnClockRestart . Ces appels sont effectués de manière asynchrone.

Si l’horloge est déjà en cours d’exécution, appeler à nouveau Démarrer a pour effet de rechercher l’horloge à la nouvelle position StartOffset .

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista [applications de bureau | applications UWP]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau | applications UWP]
Plateforme cible Windows
En-tête mfidl.h
Bibliothèque Mfuuid.lib

Voir aussi

IMFPresentationClock

Horloge de la présentation