IMiniportWaveRT：：NewStream 方法 (portcls.h)

  • 项目

方法 NewStream 创建 WaveRT 流对象的新实例。

语法

NTSTATUS NewStream(
  [out] PMINIPORTWAVERTSTREAM *Stream,
  [in]  PPORTWAVERTSTREAM     PortStream,
  [in]  ULONG                 Pin,
  [in]  BOOLEAN               Capture,
  [in]  PKSDATAFORMAT         DataFormat
);

参数

[out] Stream

新流的输出指针。 此参数指向调用方分配的指针变量，该方法在其中 NewStream 写入指向新流对象的 IMiniportWaveRTStream 接口的指针。 调用方为此参数指定有效的非 NULL 指针。

[in] PortStream

指向 IPortWaveRTStream 的指针。

[in] Pin

指定标识要打开的引脚的引脚 ID。 如果 WaveRT 微型端口驱动程序的筛选器描述符指定筛选器上的总共 n 个引脚工厂， 则 Pin 参数的有效值范围为 0 到 n-1。 有关筛选器描述符的详细信息，请参阅 筛选器工厂 主题。

[in] Capture

指定一个布尔值，该值指示是创建捕获流还是呈现流。 对于捕获 (输入) 流，此参数为 TRUE ，对于播放 (输出) 流，此参数为 FALSE 。

[in] DataFormat

指向 KSDATAFORMAT 结构的指针，该结构指定新流的数据格式。 有关更多信息，请参见下面的“备注”部分。

返回值

NewStream 如果调用成功，则返回STATUS_SUCCESS。 否则，该方法将返回相应的错误状态代码。

注解

方法 NewStream 将流的初始状态设置为 KSSTATE_STOP ，将其初始位置设置为 0。 有关详细信息，请参阅相关方法 IMiniportWaveRTStream：：SetState 和 IMiniportWaveRTStream：：GetPosition。

DataFormat 参数（指定流的数据格式）指向以下特定于音频的扩展版本的 KSDATAFORMAT 结构之一：

Stream 和 PortStream 参数遵循 COM 对象的引用计数约定。

要求

要求 值
最低受支持的客户端 在 Windows Vista 和更高版本的 Windows 操作系统中可用。
目标平台 通用
标头 portcls.h
IRQL 被动级别。

另请参阅

IMiniportWaveRT

IMiniportWaveRTStream

IMiniportWaveRTStream：：GetPosition

IMiniportWaveRTStream：：SetState

IPortWaveRTStream