itStreamControl：：CreateStream 方法 (tapi3if.h)

  • 项目

CreateStream 方法创建新的媒体流。

语法

HRESULT CreateStream(
  [in]  long               lMediaType,
  [in]  TERMINAL_DIRECTION td,
  [out] ITStream           **ppStream
);

参数

[in] lMediaType

指示流的 媒体类型 。

[in] td

指示 TERMINAL_DIRECTION。

[out] ppStream

指向新创建的 ITStream 接口的指针的指针。

返回值

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

值 含义
S_OK
 方法成功。
E_POINTER
 ppStream 参数不是有效的指针。
E_OUTOFMEMORY
 内存不足，无法执行操作。
TAPI_E_INVALIDMEDIATYPE
 lMediaType 参数不是有效的媒体类型。
TAPI_E_INVALIDDIRECTION
 td 参数不是有效的终端方向。
TAPI_E_MAXSTREAMS
 已达到支持的最大流数。
TAPI_E_NOTSUPPORTED
 不支持此操作。

注解

许多 MSP 不支持动态创建流，只是在实现此方法时返回TAPI_E_MAXSTREAMS。 创建调用时，默认流会自动可用，因此大多数应用程序不必使用此方法。

流创建或删除可能涉及与远程终结点的交互，从而导致CMC_REMOTE_REQUEST而不是在停止或启动流时收到的CMC_LOCAL_REQUEST消息。

TAPI 在 ITStreamControl：：CreateStream 返回的 ITStream 接口上调用 AddRef 方法。 应用程序必须在 ITStream 接口上调用 Release，以释放与其关联的资源。

要求

   
目标平台 Windows
标头 tapi3if.h (包括 Tapi3.h)

另请参阅

ITStreamControl

媒体服务提供程序接口 (MSPI)

TERMINAL_DIRECTION

媒体类型