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)