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::SetStateIMiniportWaveRTStream::GetPosition

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

StreamPortStream 参数遵循 COM 对象的引用计数约定。

要求

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

另请参阅

IMiniportWaveRT

IMiniportWaveRTStream

IMiniportWaveRTStream::GetPosition

IMiniportWaveRTStream::SetState

IPortWaveRTStream