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

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 de 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 interfaz de 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.

Observaciones

Al elegir un valor para pTerminalClass, los únicos GUID de clase 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 el de pTerminalClassBSTR en dos pasos: llame a stringFromIID para convertir el GUID en un LPOLESTRy, a continuación, llame a SysAllocString para convertir el LPOLESTR de en un BSTR.

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

Requisitos

Requisito	Valor
de la plataforma de destino de	Windows
encabezado de	termmgr.h

Consulte también

ITTerminalManager

TERMINAL_DIRECTION

de tipo de medio