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