IVideoWindow::GetMinIdealImageSize
| Microsoft DirectShow 9.0 |
IVideoWindow::GetMinIdealImageSize
The GetMinIdealImageSize method retrieves the minimum ideal size for the video image.
Syntax
HRESULT GetMinIdealImageSize(
long *pWidth,
long *pHeight
);
Parameters
pWidth
[out] Pointer to a variable that receives the minimum ideal width, in pixels.
pHeight
[out] Pointer to a variable that receives the minimum ideal height, in pixels.
Return Values
Possible return values include the following:
| Value | Description |
| E_POINTER | NULL pointer. |
| S_FALSE | Could not retrieve a minimum image size. |
| S_OK | Success. |
| VFW_E_WRONG_STATE | Filter is stopped. |
Remarks
The maximum ideal size may differ from the native video size, because the video hardware might have specific stretching requirements.
This method returns S_FALSE under various circumstances:
- The filter is using an IOverlay transport.
- UseWhenFullScreen mode is on. (See IDirectDrawVideo::UseWhenFullScreen.)
- Video playback is using a stretchable offscreen surface. (The dwCaps member of the DDCAPS structure includes the DDCAPS_BLTSTRETCH flag. See IDirectDrawVideo::GetCaps.)
- The video surface has no minimum overlay stretch. (The dwMinOverlayStretch member of the DDCAPS structure is zero. See IDirectDrawVideo::GetCaps.)
Requirements
Header: Declared in Control.h; include Dshow.h.
Library: Use Strmiids.lib.
See Also