ITTerminalSupport：：GetDefaultStaticTerminal 方法 (tapi3if.h)

项目
08/26/2023

GetDefaultStaticTerminal 方法获取指定媒体类型的默认静态终端。

语法

HRESULT GetDefaultStaticTerminal(
  [in]  long               lMediaType,
  [in]  TERMINAL_DIRECTION Direction,
  [out] ITTerminal         **ppTerminal
);

参数

[in] lMediaType

所需终端的媒体类型。

[in] Direction

TERMINAL_DIRECTION 终端方向的描述符。

[out] ppTerminal

指向 ITTerminal 接口的指针。如果没有可用的终端，则为 NULL。

返回值

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

值	含义
S_OK	方法成功。
S_FALSE	没有可用的终端。 *ppTerminal 将返回 NULL。
E_FAIL	错误。
E_POINTER	lMediaType 参数不是有效的指针。
E_MEDIATYPE	lMediaType 参数不是有效的媒体类型。
E_OUTOFMEMORY	内存不足，无法创建 Terminal 对象。

注解

此方法不返回动态终端。例如，媒体类型为 TAPIMEDIATYPE_VIDEO，终端方向为 TD_RENDER 定义动态终端;此方法将因这些参数而失败。

此方法返回的默认静态终端是 ITTerminalSupport：：EnumerateStaticTerminals 或 ITTerminalSupport：：get_StaticTerminals 返回的静态终端之一。通常，默认终端是在控制面板的“声音和多媒体属性”小程序中选择为“首选设备”的终端。

TAPI 在 ITTerminalSupport：：GetDefaultStaticTerminal 返回的 ITTerminal 接口上调用 AddRef 方法。应用程序必须在 ITTerminal 接口上调用 Release，以释放与之关联的资源。