Méthode CBaseReferenceClock. AdviseTime
La AdviseTime méthode crée une demande de notification à une seule capture. Cette méthode implémente la méthode IReferenceClock :: AdviseTime .
Syntaxe
HRESULT AdviseTime(
REFERENCE_TIME baseTime,
REFERENCE_TIME streamTime,
HEVENT hEvent,
DWORD_PTR *pdwAdviseToken
);
Paramètres
-
baseTime
-
Temps de référence de base, en unités de 100 nanosecondes.
-
streamTime
-
Temps de décalage du flux, en unités de 100 nanosecondes.
-
hEvent
-
Handle vers un événement, créé par l’appelant.
-
pdwAdviseToken
-
Pointeur vers une variable qui reçoit un identificateur pour la demande de notification.
Valeur retournée
Retourne l’une des valeurs HRESULT indiquées dans le tableau suivant.
| Code de retour | Description |
|---|---|
|
Succès |
|
Valeurs de temps non valides |
|
Échec |
|
Argument de pointeur null |
Remarques
Cette méthode crée une demande de notification d’une seule capture pour le streamTime de temps de référence baseTime + . La somme doit être supérieure à zéro et inférieure à la _ durée maximale, ou la méthode retourne E _ INVALIDARG. À l’heure demandée, l’horloge signale l’événement spécifié dans le paramètre hEvent .
Pour annuler la notification avant l’heure d’expiration, appelez la méthode CBaseReferenceClock :: Unadvise et transmettez la valeur pdwAdviseToken retournée à partir de cet appel. Une fois la notification effectuée, l’horloge l’efface automatiquement. il n’est donc pas nécessaire d’appeler Unadvise. Toutefois, ce n’est pas une erreur.
Configuration requise
| Condition requise | Valeur |
|---|---|
| En-tête |
|
| Bibliothèque |
|