返回流演示文稿信息。
语法
NTSTATUS GetOutputStreamPresentationPosition(
[out] KSAUDIO_PRESENTATION_POSITION *pPresentationPosition
);
参数
[out] pPresentationPosition
pPresentationPosition 返回一个 KSAUDIO_PRESENTATION_POSITION 结构,该结构表示音频数据流中的最近呈现位置。 有关详细信息,请参阅 IMiniportStreamAudioEngineNode::GetStreamPresentationPosition。
返回值
如果调用成功,GetOutputStreamPresentationPosition 返回STATUS_SUCCESS。 否则,该函数将返回适当的错误状态代码。
言论
OS 可能会定期从驱动程序获取此属性,以便从驱动程序中检索最近的演示文稿位置信息,以便允许上层将视频或其他活动与音频流同步。
在 KSAUDIO_PRESENTATION_POSITION 的 u64PositionInBlocks 成员中返回的值应与 GetPacketCount 返回的数据包计数以及驱动程序对传递给 SetWritePacket 的数据包编号的解释一致。 换句话说,数据包 0 的第一个示例是块 0。
这并不意味着 GetPacketCount 和 GetOutputStreamPresentationPosition(如果同时调用)将返回引用同一示例的值。 GetPacketCount 返回有关从 WaveRT 缓冲区传输到硬件的示例的信息,而 GetOutputStreamPresentationPosition 返回有关系统输出中提供的示例的信息。 这些是两个不同的信息片段。
要求
| 要求 | 价值 |
|---|---|
| 最低支持的客户端 | 在 Windows 10 及更高版本中可用。 |
| 目标平台 | 窗户 |
| 标头 | portcls.h |
| IRQL | 被动级别 |