IVMRMixerControl::GetOutputRect

 
Microsoft DirectShow 9.0

IVMRMixerControl::GetOutputRect

The GetOutputRect method retrieves the position of this stream's video rectangle within the composition rectangle.

Syntax

  HRESULT GetOutputRect(

  
  DWORD
  
  dwStreamID
  
  NORMALIZEDRECT*
  
  pRect

  );

Parameters

dwStreamID

[in] Specifies the input stream.

pRect

[out]  Pointer to a NORMALIZEDRECT structure that receives the destination rectangle in 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, if left is greater than right, it means the video is mirrored in the x direction. An empty rectangle turns off this stream.

Requirements

Header: Declared in Strmif.h; include Dshow.h.

Library: Use Strmiids.lib.

See Also