ITSubStreamControl::EnumerateSubStreams method (tapi3if.h)

Article
02/22/2024

The EnumerateSubStreams method enumerates currently available media substreams. Provided for C and C++ applications. Automation client applications such as Visual Basic must use the get_SubStreams method.

Syntax

HRESULT EnumerateSubStreams(
  [out] IEnumSubStream **ppEnumSubStream
);

Parameters

[out] ppEnumSubStream

Pointer to IEnumSubStream enumeration of substreams.

Return value

This method can return one of these values.

Value	Meaning
S_OK	Method succeeded.
E_OUTOFMEMORY	Insufficient memory exists to perform the operation.
E_POINTER	The ppEnumSubStream parameter is not a valid pointer.

Remarks

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

Requirements

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