IReferenceClock::AdviseTime, méthode
[La fonctionnalité associée à cette page, le Kit de développement logiciel (SDK) Windows Media Format 11, est une fonctionnalité héritée. Il a été remplacé par lecteur source et enregistreur récepteur. Le lecteur source et l’enregistreur récepteur ont été optimisés pour Windows 10 et Windows 11. Microsoft recommande vivement que le nouveau code utilise le lecteur source et l’enregistreur récepteur au lieu du Kit de développement logiciel (SDK) Windows Media Format 11, 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 méthode AdviseTime demande une notification asynchrone indiquant qu’un délai s’est écoulé.
Syntaxe
HRESULT AdviseTime(
[in] REFERENCE_TIME rtBaseTime,
[in] REFERENCE_TIME rtStreamTime,
[in] HEVENT hEvent,
[out] DWORD *pdwAdviseCookie
);
Paramètres
-
rtBaseTime [in]
-
Temps de référence de base, en unités de 100 nanosecondes.
-
rtStreamTime [in]
-
Temps de décalage du flux, en unités de 100 nanosecondes.
-
hEvent [in]
-
Gérer un événement, créé par l’appelant. Cet événement est signalé lorsque le temps spécifié s’écoule.
-
pdwAdviseCookie [out]
-
Pointeur vers une variable qui reçoit un identificateur pour la demande. Cela permet d’identifier cet appel à AdviseTime à l’avenir, par exemple pour annuler la demande.
Valeur retournée
Cette méthode retourne un code HRESULT. Les valeurs possibles sont notamment celles figurant dans le tableau suivant.
| Code de retour | Description |
|---|---|
|
S_OK |
|
Le paramètre pdwAdviseCookie a la valeur NULL. |
|
Défaillance non spécifiée. |