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
接收最大理想高度（以像素为单位）。
返回值
可能的返回值包括：
| 返回代码 | 说明 |
|---|---|
|
NULL 指针。 |
|
无法检索最大图像大小。 |
|
成功。 |
|
筛选器已停止。 |
注解
最大理想大小可能与本机视频大小不同，因为视频硬件可能有特定的拉伸要求。
此方法在各种情况下返回S_FALSE：
- 筛选器使用 IOverlay 传输。
- UseWhenFullScreen 模式处于打开状态。 (请参阅 IDirectDrawVideo：：UseWhenFullScreen.)
- 视频图面没有最大覆盖拉伸。 (DDCAPS 结构的 dwMaxOverlayStretch 成员为零。请参阅 IDirectDrawVideo：：GetCaps.)
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
| 最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | control.h (包括 Dshow.h) |
| Library | Strmiids.lib |