CBasePin::Connect
Connect メソッドは、ピンを他のピンに接続する。このメソッドは IPin::Connect メソッドを実装する。
構文
HRESULT Connect(
IPin *pReceivePin,
const AM_MEDIA_TYPE *pmt
);
パラメータ
pReceivePin
受信ピンの IPin インターフェイスへのポインタ。
pmt
接続のメディア タイプを指定する AM_MEDIA_TYPE 構造体へのポインタ。
戻り値
HRESULT 値を返す。可能な値は次の一覧のとおりである。
値 | 説明 |
S_OK | 成功。 |
VFW_E_ALREADY_CONNECTED | ピンは既に接続されている。 |
VFW_E_NO_ACCEPTABLE_TYPES | 許容可能なメディア タイプを見つけることができなかった。 |
VFW_E_NOT_STOPPED | フィルタはアクティブで、ピンは動的再接続をサポートしていない。 |
VFW_E_TYPE_NOT_ACCEPTED | 指定したメディア タイプは受け入れられない。 |
注意
pmt パラメータは NULL でもよい。メジャー タイプ、サブタイプ、またはフォーマットに GUID_NULL 値を設定して、パーシャル メディア タイプを指定することも可能である。
基底クラスでは、このメソッドはピンが既に接続されているか、フィルタが停止しているかを確認する。接続処理の残りは CBasePin::AgreeMediaType メソッドに委任する。
参照