IVideoWindow：：GetMaxIdealImageSize 方法 (control.h)

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

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

语法

HRESULT GetMaxIdealImageSize(
  [out] long *pWidth,
  [out] long *pHeight
);

参数

[out] pWidth

接收最大理想宽度（以像素为单位）。

[out] pHeight

接收最大理想高度（以像素为单位）。

返回值

可能的返回值包括：

返回代码	说明
E_POINTER	NULL 指针。
S_FALSE	无法检索最大图像大小。
S_OK	成功。
VFW_E_WRONG_STATE	筛选器已停止。

注解

最大理想大小可能与本机视频大小不同，因为视频硬件可能有特定的拉伸要求。

此方法在各种情况下返回S_FALSE：

• 筛选器使用 IOverlay 传输。
• UseWhenFullScreen 模式处于打开状态。 (请参阅 IDirectDrawVideo：：UseWhenFullScreen.)
• 视频图面没有最大覆盖拉伸。 (DDCAPS 结构的 dwMaxOverlayStretch 成员为零。请参阅 IDirectDrawVideo：：GetCaps.)

要求

要求	值
最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
目标平台	Windows
标头	control.h (包括 Dshow.h)
Library	Strmiids.lib

另请参阅

错误和成功代码

IVideoWindow 接口

IVideoWindow：：GetMinIdealImageSize