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

Artigo
07/16/2024

O método CreateDynamicTerminal cria um terminal dinâmico de uma classe de terminal, tipo de mídia e direção especificados.

Sintaxe

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

Se o MSP agregar o objeto terminal, defina como ponteiro de interface IUnknown para o objeto MSP. Normalmente, isso é definido como NULL.

[in] iidTerminalClass

GUID identificando a classe de terminal a ser criada.

[in] dwMediaType

Descritor de tipo de mídia para fluxo.

[in] Direction

TERMINAL_DIRECTION descritor da direção do fluxo de mídia para terminal.

[in] htAddress

Identificador MSP.

[out] ppTerminal

Ponteiro para interface ITTerminal para o novo terminal.

Valor de retorno

Esse método pode retornar um desses valores.

Valor	Significado
S_OK	Método bem-sucedido.
E_INVALIDARG	O parâmetro fMessageWaiting não é válido.
E_POINTER	O parâmetro ppAddress não é um ponteiro válido.

Observações

Ao escolher um valor para pTerminalClass, os únicos GUIDs de classe de terminal que podem ser usados são aqueles que correspondem a terminais criados "dinamicamente". Por exemplo, de todas as classes de terminal definidas atualmente pelo TAPI3, somente o seguinte pode ser usado com CreateTerminal: CLSID_MediaStreamTerminal e CLSID_VideoWindowTerm.

Além disso, somente as classes de terminal dinâmico com suporte nesse endereço podem ser usadas. O aplicativo pode descobrir esses valores usando ITTerminalSupport::EnumerateDynamicTerminalClasses ou ITTerminalSupport::get_DynamicTerminalClasses.

O aplicativo deve obter o pTerminalClassBSTR em duas etapas: chamar StringFromIID para converter o GUID em um LPOLESTRe, em seguida, chamar SysAllocString para converter o LPOLESTR em umBSTR .

O aplicativo deve usar SysFreeString para liberar a memória alocada para o parâmetro pTerminalClass .

Requisitos

Requisito	Valor
da Plataforma de Destino	Windows
cabeçalho	termmgr.h

Consulte também

ITTerminalManager

TERMINAL_DIRECTION

de tipo de mídia

Compartilhar via