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
_OK
Succès
E _ INVALIDARG
Valeurs de temps non valides
_OUTOFMEMORY E
Échec
_pointeur E
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
Refclock. h (inclure Flux. h)
Bibliothèque
Strmbase. lib (versions commerciales);
Strmbasd. lib (versions Debug)

Voir aussi

CBaseReferenceClock, classe