Méthode IMFPresentationTimeSource ::GetUnderlyingClock (mfidl.h)
Récupère l’horloge sous-jacente que la source de temps de présentation utilise pour générer ses heures d’horloge.
Syntaxe
HRESULT GetUnderlyingClock(
[out] IMFClock **ppClock
);
Paramètres
[out] ppClock
Reçoit un pointeur vers l’interface IMFClock de l’horloge. L’appelant doit libérer l’interface.
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 |
|
Cette source de temps n’expose pas d’horloge sous-jacente. |
Remarques
Une source de temps de présentation doit prendre en charge les modifications d’arrêt, de démarrage, de mise en pause et de débit. Toutefois, dans de nombreux cas, la source de temps dérive ses heures d’horloge d’une horloge matérielle ou d’un autre appareil. L’horloge sous-jacente est toujours en cours d’exécution et peut ne pas prendre en charge les changements de débit.
Si vous le souhaitez, une source de temps peut exposer l’horloge sous-jacente en implémentant cette méthode. L’horloge sous-jacente est toujours en cours d’exécution, même lorsque la source de temps de présentation est suspendue ou arrêtée. (Par conséquent, l’horloge sous-jacente retourne l’indicateur MFCLOCK_CHARACTERISTICS_FLAG_ALWAYS_RUNNING dans la méthode IMFClock ::GetClockCharacteristics ).
L’horloge sous-jacente est utile si vous souhaitez prendre des décisions en fonction des heures d’horloge pendant que l’horloge de la présentation est arrêtée ou suspendue.
Si la source de temps n’expose pas d’horloge sous-jacente, la méthode retourne MF_E_NO_CLOCK.
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 |