Méthode IMFPresentationClock ::Start (mfidl.h)
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 |
|
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 |