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 | 被动级别。 |
另请参阅
IMiniportWaveRTStream
IMiniportWaveRTStream::GetPosition