CPullPin.Connect 方法

  • 發行項

[與此頁面相關的功能 DirectShow是舊版功能。 它已被 MediaPlayer、 IMFMediaEngine和 Media Foundation 中的音訊/視訊擷取取代。 這些功能已針對Windows 10和Windows 11進行優化。 Microsoft 強烈建議新程式碼盡可能使用 MediaPlayer、 IMFMediaEngine 和 音訊/視訊擷取 ，而不是 DirectShow。 Microsoft 建議使用舊版 API 的現有程式碼盡可能重寫為使用新的 API。

方法 Connect 會完成輸出針腳的連接。

語法

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

參數

朋 克

輸出針腳的 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 類別