Метод ITStreamControl::CreateStream (tapi3if.h)

Статья
08/26/2023

Метод CreateStream создает новый поток мультимедиа.

Синтаксис

HRESULT CreateStream(
  [in]  long               lMediaType,
  [in]  TERMINAL_DIRECTION td,
  [out] ITStream           **ppStream
);

Параметры

[in] lMediaType

Указывает тип мультимедиа для потока.

[in] td

Указывает TERMINAL_DIRECTION.

[out] ppStream

Указатель на указатель на только что созданный интерфейс ITStream .

Возвращаемое значение

Этот метод может возвращать одно из этих значений.

Значение	Значение
S_OK	Метод успешно выполнен.
E_POINTER	Параметр ppStream не является допустимым указателем.
E_OUTOFMEMORY	Для выполнения операции недостаточно памяти.
TAPI_E_INVALIDMEDIATYPE	Параметр lMediaType не является допустимым типом мультимедиа.
TAPI_E_INVALIDDIRECTION	Параметр td не является допустимым конечным направлением.
TAPI_E_MAXSTREAMS	Достигнуто максимальное количество поддерживаемых потоков.
TAPI_E_NOTSUPPORTED	Эта операция не поддерживается.

Многие msp не поддерживают динамическое создание потоков и просто возвращают TAPI_E_MAXSTREAMS в реализации этого метода. Потоки по умолчанию автоматически доступны при создании вызова, поэтому большинству приложений не нужно использовать этот метод.

Создание или удаление потока может включать взаимодействие с удаленной конечной точкой, что приводит к CMC_REMOTE_REQUEST, а не к CMC_LOCAL_REQUEST сообщений, получаемых при остановке или запуске потока.

TAPI вызывает метод AddRef в интерфейсе ITStream, возвращенном ITStreamControl::CreateStream. Приложение должно вызвать Release в интерфейсе ITStream , чтобы освободить связанные с ним ресурсы.