ITTerminalManager ::CreateDynamicTerminal, méthode (termmgr.h)

Article
07/16/2024

La méthode CreateDynamicTerminal crée un terminal dynamique d’une classe de terminal, d’un type de support et d’une direction de terminal spécifiés.

Syntaxe

HRESULT CreateDynamicTerminal(
  [in]  IUnknown           *pOuterUnknown,
  [in]  IID                iidTerminalClass,
  [in]  DWORD              dwMediaType,
  [in]  TERMINAL_DIRECTION Direction,
  [in]  MSP_HANDLE         htAddress,
  [out] ITTerminal         **ppTerminal
);

Paramètres

[in] pOuterUnknown

Si MSP agrège l’objet terminal, définissez le pointeur d’interface IUnknown pour l’objet MSP. Cela est généralement défini sur NULL .

[in] iidTerminalClass

GUID identifiant la classe de terminal à créer.

[in] dwMediaType

Descripteur du type de média pour le flux.

[in] Direction

TERMINAL_DIRECTION descripteur du sens du flux multimédia pour le terminal.

[in] htAddress

Handle MSP.

[out] ppTerminal

Pointeur vers interface de ITTerminal pour le nouveau terminal.

Valeur de retour

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

Valeur	Signification
S_OK	Méthode réussie.
E_INVALIDARG	Le paramètre fMessage Waiting n’est pas valide.
E_POINTER	Le paramètre ppAddress n’est pas un pointeur valide.

Remarques

Lorsque vous choisissez une valeur pour pTerminalClass, les seuls GUID de classe de terminal qui peuvent être utilisés sont ceux qui correspondent aux terminaux créés de manière « dynamique ». Par exemple, à partir de toutes les classes de terminal actuellement définies par TAPI3, seules les options suivantes peuvent être utilisées avec CreateTerminal : CLSID_MediaStreamTerminal et CLSID_VideoWindowTerm.

En outre, seules les classes de terminal dynamique prises en charge sur cette adresse peuvent être utilisées. L’application peut découvrir ces valeurs à l’aide de ITTerminalSupport ::EnumerateDynamicTerminalClasses ou ITTerminalSupport ::get_DynamicTerminalClasses.

L’application doit obtenir le BSTR pTerminalClassen deux étapes : appeler StringFromIID pour convertir le GUID en LPOLESTR, puis appeler SysAllocString pour convertir le LPOLESTR enBSTR .

L’application doit utiliser SysFreeString pour libérer la mémoire allouée pour le paramètre pTerminalClass.