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 接口的指针。
返回值
此方法可以返回其中一个值。
值 | 含义 |
---|---|
|
方法成功。 |
|
ppMedia 参数不是有效的指针。 |
|
Index 参数无效。 |
|
内存不足,无法执行操作。 |
|
错误。 |
|
此方法尚未实现。 |
备注
大多数 C 和 C++ 列表都是从 0 开始的,但出于 Visual Basic 兼容性,此索引从 1 开始,这意味着第一项的索引号为 1。
TAPI 在 ITMediaCollection::Create 返回的 ITMedia 接口上调用 AddRef 方法。 应用程序必须在 ITMedia 接口上调用 Release,以释放与其关联的资源。
要求
要求 | 值 |
---|---|
TAPI 版本 |
需要 TAPI 3.0 或更高版本 |
标头 |
|
库 |
|
DLL |
|