Microsoft DirectX 8.1 (C++)

IVMRFilterConfig::SetNumberOfStreams

This topic applies to Windows XP Home Edition and Windows XP Professional only.

The SetNumberOfStreams method sets the number of streams to be mixed and instructs the VMR to go into mixer mode.

Syntax

HRESULT SetNumberOfStreams(
  DWORD  dwMaxStreams
);

Parameters

dwMaxStreams

[in]  Double word containing the maximum number of input streams that the VMR will be required to mix. Must not be greater than MAX_MIXER_STREAMS (16).

Return Values

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

Error Code Description
E_FAIL The mixer is already configured.
E_INVALIDARG An attempt was made to configure the mixer for more than 16 input streams.
E_OUTOFMEMORY Memory to manage the streams could not be allocated.

Remarks

dwMaxStreams should be equal to the number of input pins required. Pins cannot be added or removed after the VMR has been connected. If you do not know in advance how many input streams will be required, set dxMaxStreams to the maximum number that might be required. A value of 1 is valid for dwMaxStreams. This value does not cause any extra pins to be created, but it does force the VMR to go into "mixer mode."

See Also