ITMediaCollection::Create 方法

[ 会合 IP 电话会议控件和接口不适用于 Windows Vista、Windows Server 2008 和操作系统的后续版本。 RTC 客户端 API 提供类似的功能。]

Create 方法使用默认属性创建一个新媒体,将其添加到集合中的指定索引处,并返回指向 ITMedia 接口的指针。

语法

HRESULT Create(
  [in]  LONG    Index,
  [out] ITMedia **ppMedia
);

parameters

索引 [in]

新项的索引。 索引的最小值为 1,索引的最大值是当前项数 + 1。

ppMedia [out]

指向已创建的 ITMedia 接口的指针。

返回值

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

含义
S_OK
方法成功。
E_POINTER
ppMedia 参数不是有效的指针。
E_INVALIDARG
Index 参数无效。
E_OUTOFMEMORY
内存不足,无法执行操作。
E_FAIL
错误。
E_NOTIMPL
此方法尚未实现。

备注

大多数 C 和 C++ 列表都是从 0 开始的,但出于 Visual Basic 兼容性,此索引从 1 开始,这意味着第一项的索引号为 1。

TAPI 在 ITMediaCollection::Create 返回的 ITMedia 接口上调用 AddRef 方法。 应用程序必须在 ITMedia 接口上调用 Release,以释放与其关联的资源。

要求

要求
TAPI 版本
需要 TAPI 3.0 或更高版本
标头
Sdpblb.h

Uuid.lib
DLL
Sdpblb.dll

另请参阅

ITMedia

ITMediaCollection