ITSubStreamControl::EnumerateSubStreams method (tapi3if.h)

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)

See also

ITSubStreamControl

Media Service Provider Interface (MSPI)