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

Статья
07/16/2024

Метод 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 агрегирует объект терминала, установите указатель интерфейса IUnknown для объекта MSP. Обычно это значение равно 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.

Требования

Требование	Ценность
целевая платформа	Виндоус
заголовка	termmgr.h

См. также

ITTerminalManager

TERMINAL_DIRECTION

типа носителя

Поделиться через