Método ITStreamControl::CreateStream (tapi3if.h)

Artículo
08/26/2023

El método CreateStream crea una nueva secuencia multimedia.

Sintaxis

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

Parámetros

[in] lMediaType

Indica el tipo de medio para la secuencia.

[in] td

Indica el TERMINAL_DIRECTION.

[out] ppStream

Puntero al puntero para la interfaz ITStream recién creada.

Valor devuelto

Este método puede devolver uno de estos valores.

Value	Significado
S_OK	El método se realizó correctamente.
E_POINTER	El parámetro ppStream no es un puntero válido.
E_OUTOFMEMORY	Existe memoria insuficiente para realizar la operación.
TAPI_E_INVALIDMEDIATYPE	El parámetro lMediaType no es un tipo de medio válido.
TAPI_E_INVALIDDIRECTION	El parámetro td no es una dirección de terminal válida.
TAPI_E_MAXSTREAMS	Ya se ha alcanzado el número máximo de secuencias admitidas.
TAPI_E_NOTSUPPORTED	Esta operación no se admite.

Comentarios

Muchos MSP no admiten la creación dinámica de flujos y simplemente devuelven TAPI_E_MAXSTREAMS en su implementación de este método. Las secuencias predeterminadas están disponibles automáticamente cuando se crea una llamada, por lo que la mayoría de las aplicaciones no tienen que usar este método.

La creación o eliminación de flujos puede implicar la interacción con un punto de conexión remoto, lo que da lugar a un CMC_REMOTE_REQUEST en lugar de los mensajes CMC_LOCAL_REQUEST que se reciben cuando se detiene o se inicia una secuencia.

TAPI llama al método AddRef en la interfaz ITStream devuelta por ITStreamControl::CreateStream. La aplicación debe llamar a Release en la interfaz ITStream para liberar recursos asociados a ella.