Méthode CBasePin.GetConnected

[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 GetConnected méthode récupère l’épingle connectée à cette broche.

Syntaxe

IPin* GetConnected();

Paramètres

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

Valeur retournée

Retourne un pointeur vers l’interface IPin de l’autre broche.

Notes

Si l’épingle n’est pas connectée, cette méthode retourne NULL. Appelez la méthode CBasePin::IsConnected pour déterminer si l’épingle est connectée.

La méthode n’appelle pas AddRef sur l’interface IPin . L’appelant ne doit donc pas libérer l’interface.

Exemples

Étant donné que le nombre de références n’est pas incrémenté sur le pointeur retourné, vous pouvez enchaîner les appels de méthode :

if (m_MyPin->IsConnected())
{
    m_MyPin->GetConnected()->EndOfStream();
}

Ce modèle de codage est très pratique; mais comme le montre l’exemple, vous devez veiller à ne pas déréférencer un pointeur NULL lorsque l’épingle n’est pas connectée.

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