ITSubStreamControl::CreateSubStream method (tapi3if.h)

Article
02/22/2024

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)