次の方法で共有

CBasePin.GetConnected メソッド

  • [アーティクル]

[このページに関連付けられている機能 DirectShow は、従来の機能です。 MediaPlayer、IMFMediaEngine、Media Foundation のオーディオ/ビデオ キャプチャに置き換わりました。 これらの機能は、Windows 10とWindows 11用に最適化されています。 新しいコードでは、可能であれば、DirectShow ではなく Media Foundation で MediaPlayer、IMFMediaEngine、Audio/Video Capture を使用することを強くお勧めします。 Microsoft は、レガシ API を使用する既存のコードを、可能であれば新しい API を使用するように書き換えるよう提案しています。]

メソッドは GetConnected 、このピンに接続されているピンを取得します。

構文

IPin* GetConnected();

パラメーター

このメソッドにはパラメーターはありません。

戻り値

もう一方のピンの IPin インターフェイスへのポインターを返します。

解説

ピンが接続されていない場合、このメソッドは NULL を返します。 CBasePin::IsConnected メソッドを呼び出して、ピンが接続されているかどうかを確認します。

メソッドは IPin インターフェイスで AddRef を呼び出さないので、呼び出し元はインターフェイスを解放しないでください。

例

参照カウントは返されたポインターでインクリメントされないため、メソッド呼び出しを連結できます。

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

このコーディング パターンは非常に便利です。ただし、例に示すように、ピンが接続されていない場合は NULL ポインターを逆参照しないように注意する必要があります。

要件

要件 値
ヘッダー
Amfilter.h (Streams.h を含む)
ライブラリ
Strmbase.lib (製品版ビルド);
Strmbasd.lib (デバッグ ビルド)

関連項目

CBasePin クラス