IVMRMixerControl::SetOutputRect

 
Microsoft DirectShow 9.0

IVMRMixerControl::SetOutputRect

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

Syntax

  HRESULT SetOutputRect(

  
  DWORD
  
  dwStreamID
  
  const NORMALIZEDRECT*
  
  pRect

  );

Parameters

dwStreamID

[in] Specifies the input stream.

pRect

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

Return Values

If the method succeeds, it returns S_OK. If it fails, it returns an error code.

Error Code Description
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: Declared in Strmif.h; include Dshow.h.

Library: Use Strmiids.lib.

See Also