Microsoft DirectX 8.1 (C++) |
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