CTransInPlaceFilter.GetPin, méthode

[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 GetPin méthode récupère une broche.

Syntaxe

virtual CBasePin* GetPin(
   int n
);

Paramètres

n

Numéro de la broche spécifiée, indexée à partir de zéro. Sur ce filtre, la broche 0 est la broche d’entrée et l’épingle 1 est la broche de sortie.

Valeur renvoyée

Retourne un pointeur vers l’objet CBasePin qui implémente l’épingle, ou NULL si la méthode échoue.

Notes

Cette méthode remplace la méthode CTransformFilter::GetPin . La première fois que la méthode est appelée, elle crée les deux broches.

Cette méthode n’incrémente pas le nombre de références sur la broche retournée, de sorte que la broche retournée n’a pas de nombre de références en attente. Si l’appelant doit conserver une référence sur l’épingle, il doit appeler la méthode IUnknown::AddRef sur l’épingle.

Si le filtre utilise les broches CTransInPlaceInputPin et CTransInPlaceOutputPin par défaut, vous n’avez probablement pas besoin de remplacer cette méthode. Toutefois, si le filtre utilise des broches qui étendent ces classes, vous devez remplacer cette méthode pour créer des broches de ce type.

Configuration requise

Voir aussi

CTransInPlaceFilter, classe