Méthode CBaseReferenceClock.GetTime
[La fonctionnalité associée à cette page, DirectShow, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer, IMFMediaEngine et Audio/Video Capture dans Media Foundation. Ces fonctionnalités ont été optimisées pour Windows 10 et Windows 11. Microsoft recommande vivement au nouveau code d’utiliser MediaPlayer, IMFMediaEngine et La capture audio/vidéo dans Media Foundation au lieu de DirectShow, lorsque cela est possible. Microsoft suggère que le code existant qui utilise les API héritées soit réécrit pour utiliser les nouvelles API si possible.]
La GetTime méthode récupère l’heure de référence actuelle. Cette méthode implémente la méthode IReferenceClock::GetTime .
Syntaxe
HRESULT GetTime(
REFERENCE_TIME *pTime
);
Paramètres
-
pTime
-
Pointeur vers une variable qui reçoit l’heure actuelle, en unités de 100 nanosecondes.
Valeur renvoyée
Retourne l’une des valeurs HRESULT indiquées dans le tableau suivant.
| Code de retour | Description |
|---|---|
|
Argument pointeur NULL . |
|
L’heure retournée est identique à la valeur précédente. |
|
Opération réussie. |
Notes
Cette méthode appelle la méthode CBaseReferenceClock::GetPrivateTime pour déterminer l’heure d’horloge réelle. Si l’heure d’horloge est strictement supérieure à la valeur précédente, GetTime utilise l’heure d’horloge et retourne S_OK. Sinon, GetTime utilise la valeur précédente et retourne S_FALSE. Par conséquent, l’horloge interne peut s’exécuter en arrière pendant une courte période, sans entraîner l’exécution de l’heure de référence vers l’arrière. Au lieu de cela, l’heure de référence « se bloque » à la même valeur jusqu’à ce que l’horloge interne rattrape.
Configuration requise
| Condition requise | Valeur |
|---|---|
| En-tête |
|
| Bibliothèque |
|