CBasePin.Connect 方法
[與此頁面 相關的功能 DirectShow是舊版功能。 它已被 MediaPlayer、 IMFMediaEngine和 Media Foundation 中的音訊/視訊擷取取代。 這些功能已針對Windows 10和Windows 11進行優化。 Microsoft 強烈建議新程式碼盡可能使用 MediaPlayer、 IMFMediaEngine 和 音訊/視訊擷取 ,而不是 DirectShow。 Microsoft 建議盡可能重寫使用舊版 API 的現有程式碼,以使用新的 API。]
方法 Connect
會將針腳連接到另一個針腳。 這個方法會實作 IPin::Connect 方法。
語法
HRESULT Connect(
IPin *pReceivePin,
const AM_MEDIA_TYPE *pmt
);
參數
-
pReceivePin
-
接收釘選的 IPin 介面指標。
-
Pmt
-
指定連接之媒體類型的 AM_MEDIA_TYPE 結構的指標。
傳回值
傳回 HRESULT 值。 可能的值包括下表中的值。
傳回碼 | 描述 |
---|---|
|
成功。 |
|
針腳已連接。 |
|
找不到可接受的媒體類型。 |
|
篩選準則為使用中,且針腳不支援動態重新連線。 |
|
無法接受指定的媒體類型。 |
備註
pmt參數可以是Null。 它也可以指定部分媒體類型,其值為主要類型、子類型或格式GUID_Null。
在基類中,這個方法會測試是否已連接針腳,以及是否已停止篩選。 它會將其餘連線程式委派給 CBasePin::AgreeMediaType 方法。
規格需求
需求 | 值 |
---|---|
標頭 |
|
程式庫 |
|