Microsoft DirectX 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.

See Also