IVMRMixerControl9::GetOutputRect

  • Article
 
Microsoft DirectShow 9.0

IVMRMixerControl9::GetOutputRect

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

Syntax

  HRESULT GetOutputRect(
  DWORD  dwStreamID,
  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

[out]  Pointer to a NORMALIZEDRECT structure that receives the destination rectangle in 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, 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: Include D3d9.h, Vmr9.h.

Library: Use Strmiids.lib.

See Also