Compartir a través de

Método ITTerminalManager::CreateDynamicTerminal (termmgr.h)

  • Artículo

El método CreateDynamicTerminal crea un terminal dinámico de una clase de terminal, un tipo de medio y una dirección especificados.

Sintaxis

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

Parámetros

[in] pOuterUnknown

Si MSP agregará el objeto terminal, establezca en puntero de interfaz IUnknown para el objeto MSP. Normalmente, se establece en NULL.

[in] iidTerminalClass

GUID que identifica la clase de terminal que se va a crear.

[in] dwMediaType

Descriptor del tipo de medio para la secuencia.

[in] Direction

TERMINAL_DIRECTION descriptor de la dirección del flujo multimedia para el terminal.

[in] htAddress

Identificador MSP.

[out] ppTerminal

Puntero a la interfaz ITTerminal para el nuevo terminal.

Valor devuelto

Este método puede devolver uno de estos valores.

Valor Significado
S_OK
 El método se realizó correctamente.
E_INVALIDARG
 El parámetro fMessageWaiting no es válido.
E_POINTER
 El parámetro ppAddress no es un puntero válido.

Comentarios

Al elegir un valor para pTerminalClass, los únicos GUID de clase de terminal que se pueden usar son los que corresponden a los terminales que se crean "dinámicamente". Por ejemplo, desde todas las clases de terminal definidas actualmente por TAPI3, solo se puede usar lo siguiente con CreateTerminal: CLSID_MediaStreamTerminal y CLSID_VideoWindowTerm.

Además, solo se pueden usar las clases de terminal dinámico que se admiten en esta dirección. La aplicación puede detectar estos valores mediante ITTerminalSupport::EnumerateDynamicTerminalClasses o ITTerminalSupport::get_DynamicTerminalClasses.

La aplicación debe obtener pTerminalClassBSTR en dos pasos: llame a StringFromIID para convertir el GUID en un LPOLESTR y, a continuación, llame a SysAllocString para convertir LPOLESTR en un BSTR.

La aplicación debe usar SysFreeString para liberar la memoria asignada para el parámetro pTerminalClass .

Requisitos

Requisito Value
Plataforma de destino Windows
Encabezado termmgr.h

Consulte también

ITTerminalManager

TERMINAL_DIRECTION

tipo de medio