共用方式為


IPin::QueryInternalConnections 方法 (strmif.h)

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

QueryInternalConnections 方法會擷取在篩選) 內部連線到此針腳的針腳 (。

語法

HRESULT QueryInternalConnections(
  [out]     IPin  **apPin,
  [in, out] ULONG *nPin
);

參數

[out] apPin

IPin 指標數位的位址。 呼叫端會配置陣列。 方法會以 IPin 指標填入數位。 如果 nPin 為零,此參數可以是 NULL

[in, out] nPin

在輸入上,指定陣列的大小。 在輸出上,指定內部連接的針腳數目。

傳回值

傳回 HRESULT 值。 可能的值如下。

傳回碼 Description
S_FALSE
數位大小不足。
S_OK
成功。
E_NOTIMPL
未實作。

備註

這個方法會傳回輸入針腳與輸出針腳之內部對應的相關信息。 換句話說,它會描述輸入針腳如何將數據傳遞至輸出針腳。

在大部分的篩選中,每個輸入針腳都會連線到每個輸出針腳。 例如,在轉換篩選條件中,一個輸入會連線到一個輸出;在分割器篩選中,一個輸入會連線到多個輸出。 在這些情況下,方法應該只會傳回E_NOTIMPL。

否則,此方法會傳回 IPin 指標的陣列,每個針腳都會在內部對應至您查詢的針腳。 如果您在輸入針腳上呼叫 方法,陣列會包含輸出針腳的指標,反之亦然。

呼叫端會配置 IPin 指標的陣列。 若要取得必要的陣列大小,請使用 apPin 等於 NULL呼叫方法一次。 大小會在 nPin 參數中傳回。 然後配置陣列並再次呼叫 方法,將 apPin 設定為等於陣列的位址, 而 nPin 等於陣列大小。 方法接著會以 IPin 指標填入數位。 每個傳回的指標都有未處理的參考計數,而且必須由呼叫端釋放。

如果至少有一個輸入針腳實作此方法,但 nPin 中傳回零,則這個方法有另一個已被取代的用法:篩選圖形管理員會將篩選視為轉譯器篩選條件。 不過,如果您要撰寫新的轉譯器篩選,您應該實作 IAMFilterMiscFlags 介面,而不是使用此方法來指出篩選是轉譯器。

規格需求

需求
最低支援的用戶端 Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 strmif.h (包含 Dshow.h)
程式庫 Strmiids.lib

另請參閱

錯誤和成功碼

IPin 介面