ITSubStreamControl::CreateSubStream method (tapi3if.h)

The CreateSubStream method creates a substream.

Syntax

HRESULT CreateSubStream(
  [out] ITSubStream **ppSubStream
);

Parameters

[out] ppSubStream

Pointer to ITSubStream interface created.

Return value

This method can return one of these values.

Value Meaning
S_OK
Method succeeded.
E_POINTER
The ppSubStream parameter is not a valid pointer.
E_OUTOFMEMORY
Insufficient memory exists to perform the operation.
TAPI_E_MAXSTREAMS
Substream cannot be created because the maximum number of streams has already been reached.

Remarks

Many MSPs do not support dynamic creation of substreams, and simply return TAPI_E_MAXSTREAMS in their implementation of this method.

TAPI calls the AddRef method on the ITSubStream interface returned by ITSubStreamControl::CreateSubStream. The application must call Release on the ITSubStream interface to free resources associated with it.

Requirements

Requirement Value
Target Platform Windows
Header tapi3if.h (include Tapi3.h)

See also

ITSubStreamControl

Media Service Provider Interface (MSPI)