共用方式為

CDynamicOutputPin.ChangeOutputFormat 方法

  • 發行項

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

方法 ChangeOutputFormat 會動態變更連線的媒體類型，並傳遞新的區段資訊。 當篩選圖形正在執行時，可能會發生變更。 呼叫此方法之後，就無法傳遞具有舊媒體類型的範例。 呼叫端必須確保沒有任何舊的範例擱置中。

語法

HRESULT ChangeOutputFormat(
   const AM_MEDIA_TYPE  *pmt,
         REFERENCE_TIME tSegmentStart,
         REFERENCE_TIME tSegmentStop,
         double         dSegmentRate
);

參數

Pmt

指定媒體類型的 AM_MEDIA_TYPE 結構的指標。

tSegmentStart

區段的開始時間。

tSegmentStop

停止區段的時間。

dSegmentRate

區段率。

傳回值

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

傳回碼 描述
S_OK
 成功。
E_FAIL
 失敗。 可能擁有的篩選未呼叫 CDynamicOutputPin：：SetConfigInfo。
VFW_E_NOT_CONNECTED
 針腳未連線。

備註

這個方法會在篩選執行時變更格式類型。 如果下游針腳接受新的格式，則不需要重新連線。 否則，方法會嘗試重新連接針腳。 如果方法成功變更格式，則會傳遞新的區段資訊。 這個方法會呼叫 CDynamicOutputPin：：ChangeMediaType 方法來執行格式變更。

您必須先呼叫 CDynamicOutputPin：：StartUsingOutputPin 方法，才能呼叫此方法。

規格需求

需求 值
標頭
Amfilter.h (包含 Streams.h)
程式庫
Strmbase.lib (零售組建) ;
Strmbasd.lib (偵錯組建)

另請參閱

CDynamicOutputPin 類別