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 |
|---|---|
|
Succès |
|
Valeurs de temps non valides |
|
Échec |
|
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 |
|
| Bibliothèque |
|