Méthode CBaseReferenceClock. AdvisePeriodic

La AdvisePeriodic méthode crée une demande de notification périodique. Cette méthode implémente la méthode IReferenceClock :: AdvisePeriodic .

Syntaxe

HRESULT AdvisePeriodic(
   REFERENCE_TIME StartTime,
   REFERENCE_TIME PeriodTime,
   HSEMAPHORE     hSemaphore,
   DWORD_PTR      *pdwAdviseToken
);

Paramètres

StartTime

Heure de la première notification, en unités de 100 nanosecondes. Doit être supérieur à zéro et inférieur à la _ durée maximale.

PeriodTime

Temps entre les notifications, en unités de 100 nanosecondes. Doit être supérieur à zéro.

hSemaphore

Handle vers un sémaphore, créé par l’appelant.

pdwAdviseToken

Pointeur vers une variable qui reçoit un identificateur pour la demande de notification.

Valeur de retour

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

Notes

À chaque heure de notification, l’horloge libère le sémaphore spécifié dans le paramètre hSemaphore . Quand aucune autre notification n’est requise, appelez la méthode CBaseReferenceClock :: Unadvise et transmettez la valeur pdwAdviseToken retournée à partir de cet appel.

Spécifications

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