Platform SDK: TAPI

ITStreamControl::CreateStream

Creates a new media stream.

HRESULT CreateStream(
  long lMediaType,
  TERMINAL_DIRECTION td,
  ITStream **ppStream
);

Parameters

lMediaType
[in] Indicates media type for stream.
td
[in] Indicates the TERMINAL_DIRECTION.
ppStream
[out, retval] Pointer to pointer for newly created ITStream interface.

Return Values

Value Meaning
S_OK Method succeeded.
E_POINTER The ppStream parameter is not a valid pointer.
E_OUTOFMEMORY Insufficient memory exists to perform the operation.
TAPI_E_INVALIDMEDIATYPE The lMediaType parameter is not a valid media type.
TAPI_E_INVALIDDIRECTION The td parameter is not a valid terminal direction.
TAPI_E_MAXSTREAMS The maximum number of streams supported has already been reached.
TAPI_E_NOTSUPPORTED This operation is not supported.

Remarks

Many MSPs do not support dynamic creation of streams, and simply return TAPI_E_MAXSTREAMS in their implementation of this method. Default streams are automatically available when a call is created, so most applications do not have to use this method.

Requirements

  Windows NT/2000: Requires Windows 2000.
  Version: Requires TAPI 3.0 or later.
  Header: Declared in Tapi3.h.
  Library: Use T3iid.lib.

See Also

Media Service Provider Interface (MSPI), ITStreamControl, TERMINAL_DIRECTION, media type