Compartir a través de


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

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.

Requisitos

   
Plataforma de destino Windows
Encabezado tapi3if.h (include Tapi3.h)

Consulte también

ITStreamControl

Interfaz del proveedor de servicios multimedia (MSPI)

TERMINAL_DIRECTION

tipo de medio