CPullPin.Connect メソッド

  • [アーティクル]

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

メソッドは Connect 、出力ピンへの接続を完了します。

構文

HRESULT Connect(
   IUnknown      *pUnk,
   IMemAllocator *pAlloc,
   BOOL          bSync
);

パラメーター

pUnk

出力ピンの IUnknown インターフェイスへのポインター。

pAlloc

入力ピンの優先アロケーター (NULL) の IMemAllocator インターフェイスへのポインター。

bSync

同期読み取りを使用するかどうかを指定するブール値。 TRUE の場合、ピンは出力ピンに対して同期読み取り操作を実行します。 FALSE の場合、ピンは非同期の読み取り要求を行います。

戻り値

HRESULT を返します。 使用可能な値は次のとおりです。

リターン コード 説明
S_OK
 成功しました。
VFW_E_ALREADY_CONNECTED
 入力ピンは既に接続されています。
E_NOINTERFACE
 出力ピンは IAsyncReader を公開しません。

解説

入力ピンの接続プロセス中にこのメソッドを呼び出します。 メソッドが失敗した場合、ピンは接続に失敗します。

このメソッドは、 IAsyncReader インターフェイスの出力ピンを照会します。 成功した場合、 CPullPin::D ecideAllocator を呼び出して、接続のアロケーターをネゴシエートします。 入力ピンに優先アロケーターがある場合は、 pAlloc パラメーターで指定します。 DecideAllocator メソッドは、このポインターを出力ピンの IAsyncReader::RequestAllocator メソッドに渡します。 それ以外の場合は、 pAlloc を NULL に設定 します。

bSync の値が TRUE の場合、CPullPin オブジェクトは、出力ピンの IAsyncReader::SyncReadAligned を呼び出して同期読み取り要求を行います。 それ以外の場合は、 IAsyncReader::Request メソッドを呼び出して、重複する読み取り要求を行います。

要件

要件 値
ヘッダー
Pullpin.h
ライブラリ
Strmbase.lib (小売ビルド);
Strmbasd.lib (デバッグ ビルド)

関連項目

CPullPin クラス