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 を返します。 使用可能な値は次のとおりです。
リターン コード | 説明 |
---|---|
|
成功しました。 |
|
入力ピンは既に接続されています。 |
|
出力ピンは IAsyncReader を公開しません。 |
解説
入力ピンの接続プロセス中にこのメソッドを呼び出します。 メソッドが失敗した場合、ピンは接続に失敗します。
このメソッドは、 IAsyncReader インターフェイスの出力ピンを照会します。 成功した場合、 CPullPin::D ecideAllocator を呼び出して、接続のアロケーターをネゴシエートします。 入力ピンに優先アロケーターがある場合は、 pAlloc パラメーターで指定します。 DecideAllocator メソッドは、このポインターを出力ピンの IAsyncReader::RequestAllocator メソッドに渡します。 それ以外の場合は、 pAlloc を NULL に設定 します。
bSync の値が TRUE の場合、CPullPin オブジェクトは、出力ピンの IAsyncReader::SyncReadAligned を呼び出して同期読み取り要求を行います。 それ以外の場合は、 IAsyncReader::Request メソッドを呼び出して、重複する読み取り要求を行います。
要件
要件 | 値 |
---|---|
ヘッダー |
|
ライブラリ |
|