IReferenceClock ::AdviseTime, méthode (strmif.h)

Article
03/02/2024

[La fonctionnalité associée à cette page, DirectShow, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer, IMFMediaEngine et Audio/Video Capture dans Media Foundation. Ces fonctionnalités ont été optimisées pour Windows 10 et Windows 11. Microsoft recommande vivement au nouveau code d’utiliser MediaPlayer, IMFMediaEngine et La capture audio/vidéo dans Media Foundation au lieu de DirectShow, 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 AdviseTime méthode crée une demande d’avis one-shot.

Syntaxe

HRESULT AdviseTime(
  [in]  REFERENCE_TIME baseTime,
  [in]  REFERENCE_TIME streamTime,
  [in]  HEVENT         hEvent,
  [out] DWORD_PTR      *pdwAdviseCookie
);

Paramètres

[in] baseTime

Temps de référence de base, en unités de 100 nanosecondes. Consultez la section Notes.

[in] streamTime

Stream temps de décalage, en unités de 100 nanosecondes. Consultez la section Notes.

[in] hEvent

Gérer un événement, créé par l’appelant.

[out] pdwAdviseCookie

Pointeur vers une variable qui reçoit un identificateur pour la demande d’avis.

Valeur retournée

Retourne une valeur HRESULT . Les valeurs possibles sont les suivantes.

Code de retour	Description
S_OK	Réussite.
E_INVALIDARG	Valeurs de temps non valides.
E_OUTOFMEMORY	Échec.
E_POINTER	Argument pointeur NULL .

Remarques

Cette méthode crée une demande d’avis one-shot pour l’heure de référence rtBaseTime + rtStreamTime. La somme doit être supérieure à zéro et inférieure à MAX_TIME, 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 que l’heure soit atteinte, appelez la méthode Unadvise et transmettez la valeur pdwAdviseToken retournée par 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
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	strmif.h (include Dshow.h)
Bibliothèque	Strmiids.lib

Voir aussi

Codes d’erreur et de réussite

IReferenceClock, interface

Share via