IPin 介面 (strmif.h)
[與此頁面相關的功能 DirectShow 是舊版功能。 它已被 MediaPlayer、 IMFMediaEngine 和 Media Foundation 中的音訊/視訊擷取取代。 這些功能已針對 Windows 10 和 Windows 11 進行優化。 Microsoft 強烈建議新程式代碼盡可能使用 MediaPlayer、 IMFMediaEngine 和 音訊/視訊擷取 ,而不是 DirectShow。 Microsoft 建議使用舊版 API 的現有程式代碼盡可能重寫為使用新的 API。
此介面會由所有輸入和輸出針腳公開。
篩選圖形管理員會使用此介面來連接針腳並執行排清作業。 應用程式可以使用這個介面來查詢釘選以取得資訊。 應用程式不應該呼叫IPin
變更針腳狀態的方法,例如 Connect、Disconnect、BeginFlush 或 EndFlush。 若要連接針腳,應用程式必須使用 IGraphBuilder 中的方法。
篩選開發人員: CBasePin、CBaseInputPin 和 CBaseOutputPin 類別會實作此介面。 其他基類衍生自這三個類別。
繼承
IPin 介面繼承自 IUnknown 介面。 IPin 也有下列類型的成員:
方法
IPin 介面具有這些方法。
IPin::BeginFlush BeginFlush 方法會開始排清作業。 (IPin.BeginFlush) |
IPin::Connect Connect 方法會將針腳連接到另一個針腳。 |
IPin::ConnectedTo ConnectedTo 方法會擷取連接針腳的指標,如果有的話。 |
IPin::ConnectionMediaType ConnectionMediaType 方法會擷取目前針腳連線的媒體類型,如果有的話。 |
IPin::D isconnect Disconnect 方法會中斷目前的針腳連接。 |
IPin::EndFlush EndFlush 方法會結束排清作業。 (IPin.EndFlush) |
IPin::EndOfStream EndOfStream 方法會通知針腳,直到新的執行命令發出至篩選條件之前,才預期沒有其他數據。 |
IPin::EnumMediaTypes EnumMediaTypes 方法會列舉針腳的慣用媒體類型。 |
IPin::NewSegment NewSegment 方法會通知接腳,指出此呼叫之後收到的媒體樣本會分組為區段,並具有常見的開始時間、停止時間和速率。 |
IPin::QueryAccept QueryAccept 方法會判斷針腳是否接受指定的媒體類型。 |
IPin::QueryDirection QueryDirection 方法會取得針腳的方向, (輸入或輸出) 。 |
IPin::QueryId QueryId 方法會擷取針腳的標識碼。 |
IPin::QueryInternalConnections QueryInternalConnections 方法會擷取在篩選) 內部連線到此針腳的針腳 (。 |
IPin::QueryPinInfo QueryPinInfo 方法會擷取針腳的相關信息。 |
IPin::ReceiveConnection ReceiveConnection 方法接受另一個針腳的連線。 |
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 2000 專業版 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | strmif.h (包含 Dshow.h) |