itStreamControl::CreateStream 方法 (tapi3if.h)
CreateStream 方法创建新的媒体流。
语法
HRESULT CreateStream(
[in] long lMediaType,
[in] TERMINAL_DIRECTION td,
[out] ITStream **ppStream
);
参数
[in] lMediaType
指示流的 媒体类型 。
[in] td
[out] ppStream
指向新创建的 ITStream 接口的指针的指针。
返回值
此方法可以返回其中一个值。
值 | 含义 |
---|---|
|
方法成功。 |
|
ppStream 参数不是有效的指针。 |
|
内存不足,无法执行操作。 |
|
lMediaType 参数不是有效的媒体类型。 |
|
td 参数不是有效的终端方向。 |
|
已达到支持的最大流数。 |
|
不支持此操作。 |
注解
许多 MSP 不支持动态创建流,只是在实现此方法时返回TAPI_E_MAXSTREAMS。 创建调用时,默认流会自动可用,因此大多数应用程序不必使用此方法。
流创建或删除可能涉及与远程终结点的交互,从而导致CMC_REMOTE_REQUEST而不是在停止或启动流时收到的CMC_LOCAL_REQUEST消息。
TAPI 在 ITStreamControl::CreateStream 返回的 ITStream 接口上调用 AddRef 方法。 应用程序必须在 ITStream 接口上调用 Release,以释放与其关联的资源。
要求
目标平台 | Windows |
标头 | tapi3if.h (包括 Tapi3.h) |