Share via


IPin::Disconnect

Disconnect メソッドは、現在のピン接続を解除する。

フィルタ グラフ マネージャは、2 つのフィルタを切断するときにこのメソッドを呼び出す。アプリケーションからこのメソッドを呼び出さないこと。代わりに、フィルタ グラフ マネージャで IFilterGraph::Disconnect メソッドを呼び出す。

構文

  HRESULT Disconnect(void); 

戻り値

HRESULT 値を返す。可能な値は次のとおりである。

説明
S_FALSE ピンは接続されていなかった。
S_OK 成功。
VFW_E_NOT_STOPPED フィルタがアクティブ。

注意

フィルタがポーズか実行中の場合、このメソッドは失敗する。ピンが IPinConnection インターフェイスをサポートする場合、フィルタがポーズか実行中のとき、IPinConnection::DynamicDisconnect を呼び出してピンの接続を解除すること。

このメソッドは、ピン接続の接続相手のピンは切断しない。

参照