CBaseControlWindow.GetMaxIdealImageSize 方法

  • 项目

[与此页面关联的功能 DirectShow 是旧版功能。 它已被 MediaPlayer、 IMFMediaEngine 和 Media Foundation 中的音频/视频捕获所取代。 这些功能已针对Windows 10和Windows 11进行了优化。 Microsoft 强烈建议新代码尽可能在 Media Foundation 中使用 MediaPlayer、 IMFMediaEngine 和 音频/视频捕获 ，而不是 DirectShow。 如果可能，Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]

方法 GetMaxIdealImageSize 检索最大理想图像大小。

语法

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

参数

pWidth

指向最大理想宽度（以像素为单位）的指针。

pHeight

指向最大理想高度（以像素为单位）的指针。

返回值

返回 HRESULT 值。

备注

各种呈现器对可以显示的图像大小都有性能限制。 尽管当请求显示大于指定最大值的图像时，它们仍应正常运行，但呈现器可以通过 IVideoWindow 接口指定最小和最大理想大小。 仅当筛选器图已暂停或正在运行时，才能调用此接口，因为它直到分配资源，呈现器才能识别其限制。 如果没有限制，呈现器使用本机视频维度填充 pWidth 和 pHeight 参数，并返回S_FALSE。 如果存在限制，则输入受限宽度和高度，成员函数返回S_OK。

尺寸适用于目标视频的大小，而不是整个窗口大小。 因此，在计算要设置的窗口大小时，考虑当前窗口样式 (例如，WS_CAPTION和WS_BORDER) 。

要求

要求 值
标头
Ctlutil.h (包括 Streams.h)
库
Strmbase.lib (零售版本) ;
Strmbasd.lib (调试生成)

另请参阅

CBaseControlWindow 类