ITTerminalManager：：CreateDynamicTerminal 方法 (termmgr.h)

  • 项目

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

指向新终端 的 IT 终端 接口的指针。

返回值

此方法可以返回其中一个值。

值 含义
S_OK
 方法成功。
E_INVALIDARG
 fMessageWaiting 参数无效。
E_POINTER
 ppAddress 参数不是有效的指针。

注解

为 pTerminalClass 选择值时，唯一可以使用的终端类 GUID 是对应于“动态”创建的终端的 GUID。 例如，在 TAPI3 当前定义的所有终端类中，只有以下内容可用于 CreateTerminal：CLSID_MediaStreamTerminal 和 CLSID_VideoWindowTerm。

此外，只能使用此地址支持的那些动态终端类。 应用程序可以使用 ITTerminalSupport：：EnumerateDynamicTerminalClasses 或 ITTerminalSupport：：get_DynamicTerminalClasses 来发现这些值。

应用程序必须通过两个步骤获取 pTerminalClassBSTR ：调用 StringFromIID 将 GUID 转换为 LPOLESTR，然后调用 SysAllocString 将 LPOLESTR 转换为 BSTR。

应用程序必须使用 SysFreeString 来释放为 pTerminalClass 参数分配的内存。

要求

要求 值
目标平台 Windows
标头 termmgr.h

另请参阅

ITTerminalManager

TERMINAL_DIRECTION

媒体类型