CBasePin.AgreeMediaType 方法

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

方法會 AgreeMediaType 搜尋媒體類型以建立釘選連線。

語法

virtual HRESULT AgreeMediaType(
         IPin       *pReceivePin,
   const CMediaType *pmt
);

參數

pReceivePin

接收釘選的 IPin 介面指標。

Pmt

指定媒體類型或Null之CMediaType物件的指標。

傳回值

傳回 HRESULT 值。 可能的值包括下表中的值。

備註

如果 pmt 參數為非Null ，且完全指定媒體類型，此方法會嘗試使用該媒體類型進行連線。 如果嘗試失敗，方法會傳回錯誤。

如果 pmt 參數為 Null 或指定部分媒體類型，此方法會以下列順序嘗試媒體類型：

1. 接收釘選的慣用媒體類型。
2. 此釘選的慣用媒體類型。

慣用媒體類型是使用 CBasePin：：EnumMediaTypes 方法列舉，而產生的列舉值會傳遞至 CBasePin：：TryMediaTypes 方法。

規格需求

另請參閱

CBasePin 類別