Метод ITTerminalManager::CreateDynamicTerminal (termmgr.h)

Статья
08/26/2023

Метод CreateDynamicTerminal создает динамический терминал указанного класса терминала, типа носителя и направления.

Синтаксис

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

Параметры

[in] pOuterUnknown

Если MSP будет агрегировать объект терминала, задайте для объекта MSP указатель интерфейса IUnknown. Обычно для этого параметра задано значение NULL.

[in] iidTerminalClass

GUID, определяющий класс создаваемого терминала.

[in] dwMediaType

Дескриптор типа мультимедиа для потока.

[in] Direction

TERMINAL_DIRECTION дескриптор направления потока мультимедиа для терминала.

[in] htAddress

Дескриптор MSP.

[out] ppTerminal

Указатель на интерфейс ITTerminal для нового терминала.

Возвращаемое значение

Этот метод может возвращать одно из этих значений.

Значение	Значение
S_OK	Метод успешно выполнен.
E_INVALIDARG	Недопустимый параметр fMessageWaiting .
E_POINTER	Параметр ppAddress не является допустимым указателем.

При выборе значения для pTerminalClass можно использовать только идентификаторы GUID класса терминала, которые соответствуют терминалам, созданным динамически. Например, из всех классов терминалов, определенных в настоящее время TAPI3, с CreateTerminal можно использовать только следующие классы: CLSID_MediaStreamTerminal и CLSID_VideoWindowTerm.

Кроме того, можно использовать только те динамические классы терминалов, которые поддерживаются для этого адреса. Приложение может обнаружить эти значения с помощью itTerminalSupport::EnumerateDynamicTerminalClasses или ITTerminalSupport::get_DynamicTerminalClasses.

Приложение должно получить pTerminalClassBSTR в два этапа: вызовите StringFromIID для преобразования GUID в LPOLESTR, а затем вызовите SysAllocString , чтобы преобразовать LPOLESTR в BSTR.

Приложение должно использовать SysFreeString , чтобы освободить память, выделенную для параметра pTerminalClass .