IVideoWindow::GetMinIdealImageSize

Microsoft DirectShow 9.0

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

Additional resources