Metodo ITStreamControl::CreateStream (tapi3if.h)

Articolo
08/26/2023

Il metodo CreateStream crea un nuovo flusso multimediale.

Sintassi

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

Parametri

[in] lMediaType

Indica il tipo di supporto per il flusso.

[in] td

Indica la TERMINAL_DIRECTION.

[out] ppStream

Puntatore a puntatore per l'interfaccia ITStream appena creata.

Valore restituito

Questo metodo può restituire uno di questi valori.

Valore	Significato
S_OK	Il metodo è riuscito.
E_POINTER	Il parametro ppStream non è un puntatore valido.
E_OUTOFMEMORY	Memoria insufficiente per eseguire l'operazione.
TAPI_E_INVALIDMEDIATYPE	Il parametro lMediaType non è un tipo di supporto valido.
TAPI_E_INVALIDDIRECTION	Il parametro td non è una direzione del terminale valida.
TAPI_E_MAXSTREAMS	Il numero massimo di flussi supportati è già stato raggiunto.
TAPI_E_NOTSUPPORTED	Operazione non supportata.

Commenti

Molti provider di servizi di sicurezza non supportano la creazione dinamica di flussi e restituiscono semplicemente TAPI_E_MAXSTREAMS nell'implementazione di questo metodo. I flussi predefiniti sono disponibili automaticamente quando viene creata una chiamata, quindi la maggior parte delle applicazioni non deve usare questo metodo.

La creazione o la rimozione del flusso possono comportare l'interazione con un endpoint remoto, causando un CMC_REMOTE_REQUEST anziché i messaggi CMC_LOCAL_REQUEST ricevuti quando un flusso viene arrestato o avviato.

TAPI chiama il metodo AddRef nell'interfaccia ITStream restituita da ITStreamControl::CreateStream. L'applicazione deve chiamare Release nell'interfaccia ITStream per liberare risorse associate.