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

Artigo
08/26/2023

O método CreateStream cria um novo fluxo de mídia.

Sintaxe

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

Parâmetros

[in] lMediaType

Indica o tipo de mídia para stream.

[in] td

Indica o TERMINAL_DIRECTION.

[out] ppStream

Ponteiro para o ponteiro para a interface ITStream recém-criada.

Valor retornado

Esse método pode retornar um desses valores.

Valor	Significado
S_OK	O método foi bem-sucedido.
E_POINTER	O parâmetro ppStream não é um ponteiro válido.
E_OUTOFMEMORY	Existe memória insuficiente para executar a operação.
TAPI_E_INVALIDMEDIATYPE	O parâmetro lMediaType não é um tipo de mídia válido.
TAPI_E_INVALIDDIRECTION	O parâmetro td não é uma direção de terminal válida.
TAPI_E_MAXSTREAMS	O número máximo de fluxos com suporte já foi atingido.
TAPI_E_NOTSUPPORTED	Não há suporte para essa operação.

Comentários

Muitos MSPs não dão suporte à criação dinâmica de fluxos e simplesmente retornam TAPI_E_MAXSTREAMS em sua implementação desse método. Os fluxos padrão ficam disponíveis automaticamente quando uma chamada é criada, portanto, a maioria dos aplicativos não precisa usar esse método.

A criação ou remoção de fluxo pode envolver interação com um ponto de extremidade remoto, resultando em uma CMC_REMOTE_REQUEST em vez das mensagens de CMC_LOCAL_REQUEST recebidas quando um fluxo é interrompido ou iniciado.

O TAPI chama o método AddRef na interface ITStream retornada por ITStreamControl::CreateStream. O aplicativo deve chamar Release na interface ITStream para liberar recursos associados a ele.