CTransInPlaceFilter.GetPin 方法
[與此頁面相關的功能 DirectShow是舊版功能。 它已被 MediaPlayer、 IMFMediaEngine和 Media Foundation 中的音訊/視訊擷取取代。 這些功能已針對Windows 10和Windows 11進行優化。 Microsoft 強烈建議新程式碼盡可能使用 MediaPlayer、 IMFMediaEngine 和 音訊/視訊擷取 ,而不是 DirectShow。 Microsoft 建議使用舊版 API 的現有程式碼盡可能重寫為使用新的 API。
方法會 GetPin
擷取針腳。
語法
virtual CBasePin* GetPin(
int n
);
參數
-
n
-
指定針腳的數目,從零編制索引。 在此篩選上,針腳 0 是輸入針腳,針腳 1 是輸出針腳。
傳回值
傳回 CBasePin 物件的指標,這個物件會實作針腳,如果方法失敗,則傳回 Null 。
備註
這個方法會覆寫 CTransformFilter::GetPin 方法。 第一次呼叫 方法時,它會建立這兩個針腳。
此方法不會在傳回的針腳上遞增參考計數,因此傳回的針腳沒有未處理的參考計數。 如果呼叫端需要在針腳上保留參考,它應該在針腳上呼叫 IUnknown::AddRef 方法。
如果篩選準則使用預設 的 CTransInPlaceInputPin 和 CTransInPlaceOutputPin 針腳,您可能不需要覆寫此方法。 不過,如果篩選使用擴充這些類別的針腳,您必須覆寫這個方法,以建立該類型的針腳。
規格需求
需求 | 值 |
---|---|
標頭 |
|
程式庫 |
|