IMFTransform::AddInputStreams method (mftransform.h)

Article
10/13/2021

Adds one or more new input streams to this Media Foundation transform (MFT).

Syntax

HRESULT AddInputStreams(
  [in] DWORD cStreams,
  [in] DWORD *adwStreamIDs
);

Parameters

[in] cStreams

Number of streams to add.

[in] adwStreamIDs

Array of stream identifiers. The new stream identifiers must not match any existing input streams.

Return value

The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.

Return code	Description
S_OK	The method succeeded.
E_INVALIDARG	Invalid argument.
E_NOTIMPL	The MFT has a fixed number of input streams.

Remarks

If the new streams exceed the maximum number of input streams for this transform, the method returns E_INVALIDARG. To find the maximum number of input streams, call IMFTransform::GetStreamLimits.

If any of the new stream identifiers conflicts with an existing input stream, the method returns E_INVALIDARG.

If MFT_UNIQUE_METHOD_NAMES is defined before including mftransform.h, this method is renamed MFTAddInputStreams. See Creating Hybrid DMO/MFT Objects.

Requirements

Requirement	Value
Minimum supported client	Windows Vista [desktop apps \| UWP apps]
Minimum supported server	Windows Server 2008 [desktop apps \| UWP apps]
Target Platform	Windows
Header	mftransform.h
Library	Mfuuid.lib