IVMRMixerControl9::SetOutputRect

  • Article
 
Microsoft DirectShow 9.0

IVMRMixerControl9::SetOutputRect

The SetOutputRect method sets the position of this stream within the composition rectangle.

Syntax

  HRESULT SetOutputRect(
  DWORD  dwStreamID,
  const VMR9NormalizedRect*  pRect
);

Parameters

dwStreamID

[in]  Specifies the input stream. This value corresponds to the input pin. For example, the first input pin is stream 0.

pRect

[in]  Pointer to a VMR9NormalizedRect structure that specifies the position of the rectangle with composition space.

Return Values

The method returns an HRESULT. Possible values include those in the following table.

Value Description
S_OK The method succeeded.
E_POINTER pRect is invalid.
VFW_E_NOT_CONNECTED The pin is not connected.

Remarks

Because this rectangle exists in compositional space, there is no such thing as an "invalid" rectangle. For example, set left greater than right to mirror the video in the x direction. Specifying an empty rectangle turns off this stream.

Requirements

Header: Include D3d9.h, Vmr9.h.

Library: Use Strmiids.lib.

See Also