ITStreamControl::CreateStream, méthode (tapi3if.h)

Article
08/26/2023

La méthode CreateStream crée un flux multimédia.

Syntaxe

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

Paramètres

[in] lMediaType

Indique le type de média pour le flux.

[in] td

Indique le TERMINAL_DIRECTION.

[out] ppStream

Pointeur vers pointeur pour l’interface ITStream nouvellement créée.

Valeur retournée

Cette méthode peut retourner l’une de ces valeurs.

Valeur	Signification
S_OK	La méthode a réussi.
E_POINTER	Le paramètre ppStream n’est pas un pointeur valide.
E_OUTOFMEMORY	La mémoire est insuffisante pour effectuer l’opération.
TAPI_E_INVALIDMEDIATYPE	Le paramètre lMediaType n’est pas un type de média valide.
TAPI_E_INVALIDDIRECTION	Le paramètre td n’est pas une direction de terminal valide.
TAPI_E_MAXSTREAMS	Le nombre maximal de flux pris en charge a déjà été atteint.
TAPI_E_NOTSUPPORTED	Cette opération n'est pas prise en charge.

Remarques

De nombreux MSP ne prennent pas en charge la création dynamique de flux et retournent simplement des TAPI_E_MAXSTREAMS dans leur implémentation de cette méthode. Les flux par défaut étant automatiquement disponibles lors de la création d’un appel, la plupart des applications n’ont pas besoin d’utiliser cette méthode.

La création ou la suppression de flux peut impliquer une interaction avec un point de terminaison distant, ce qui entraîne une CMC_REMOTE_REQUEST plutôt que les messages CMC_LOCAL_REQUEST reçus lors de l’arrêt ou du démarrage d’un flux.

TAPI appelle la méthode AddRef sur l’interface ITStream retournée par ITStreamControl::CreateStream. L’application doit appeler Release sur l’interface ITStream pour libérer les ressources qui lui sont associées.