IPin：：QueryInternalConnections 方法 (strmif.h)

[與此頁面相關的功能 DirectShow 是舊版功能。 它已被 MediaPlayer、 IMFMediaEngine 和 Media Foundation 中的音訊/視訊擷取取代。 這些功能已針對 Windows 10 和 Windows 11 進行優化。 Microsoft 強烈建議新程式代碼盡可能使用 MediaPlayer、 IMFMediaEngine 和 音訊/視訊擷取 ，而不是 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 介面