IVideoWindow::GetMaxIdealImageSize

Microsoft DirectShow 9.0

The GetMaxIdealImageSize method retrieves the maximum ideal image size for the video image.

Syntax

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

Parameters

pWidth

[out] Pointer to a variable that receives the maximum ideal width, in pixels.

pHeight

[out] Pointer to a variable that receives the maximum ideal height, in pixels.

Return Values

Possible return values include the following:

Value	Description
E_POINTER	NULL pointer.
S_FALSE	Could not retrieve a maximum 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.)
The video surface has no maximum overlay stretch. (The dwMaxOverlayStretch 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