共用方式為


CBaseControlWindow.GetMinIdealImageSize 方法

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

方法會 GetMinIdealImageSize 擷取最理想的影像大小。

語法

HRESULT GetMinIdealImageSize(
   long *pWidth,
   long *pHeight
);

參數

pWidth

最小理想寬度的指標,以圖元為單位。

pHeight

最小理想高度的指標,以圖元為單位。

傳回值

傳回 HRESULT 值。

備註

各種轉譯器對可以顯示的影像大小有效能限制。 雖然當要求顯示大於指定最大值的影像時,它們仍應該正常運作,但轉譯器可以透過 IVideoWindow 介面來指定最小和最大的理想大小。 只有在篩選圖形暫停或執行時,才能呼叫這個介面,因為直到配置該資源為止,轉譯器才能辨識其限制。 如果沒有限制,轉譯器會以原生視訊維度填入 pWidthpHeight 參數,並傳回S_FALSE。 如果限制存在,則會輸入受限制的寬度和高度,而成員函式會傳回S_OK。

維度會套用至目的地視訊的大小,而不是套用至整體視窗大小。 因此,計算要設定的視窗大小時,請考慮目前視窗樣式 (例如,WS_CAPTION和WS_BORDER) 。

規格需求

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

另請參閱

CBaseControlWindow 類別