CBasePin.Active, méthode

  • Article

[La fonctionnalité associée à cette page, DirectShow, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer, IMFMediaEngine et Audio/Video Capture in Media Foundation. Ces fonctionnalités ont été optimisées pour Windows 10 et Windows 11. Microsoft recommande vivement que le nouveau code utilise MediaPlayer, IMFMediaEngine et Audio/Video Capture dans Media Foundation au lieu de DirectShow, si 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 Active méthode avertit l’épingle que le filtre est maintenant actif.

Syntaxe

virtual HRESULT Active();

Paramètres

Cette méthode n’a aucun paramètre.

Valeur retournée

Retourne S_OK.

Notes

Lorsque le filtre passe de arrêté à suspendu, la classe CBaseFilter appelle cette méthode sur toutes les broches connectées du filtre.

Cette méthode ne fait rien dans la classe de base. Les classes dérivées peuvent remplacer cette méthode ; par exemple, une broche peut valider des allocateurs ou obtenir des ressources matérielles.

L’état interne du gestionnaire de graphe de filtres n’est mis à jour qu’après le retour de cette fonction membre. Par conséquent, ne testez pas l’état de cette méthode.

Configuration requise

Condition requise Valeur
En-tête
Amfilter.h (include Streams.h)
Bibliothèque
Strmbase.lib (builds de vente au détail) ;
Strmbasd.lib (builds de débogage)

Voir aussi

CBasePin, classe