KsStreamPointerAdvance 函数 (ks.h)
KsStreamPointerAdvance 函数将流指针推进到下一个数据帧。
语法
KSDDKAPI NTSTATUS KsStreamPointerAdvance(
[in] PKSSTREAM_POINTER StreamPointer
);
参数
[in] StreamPointer
指向 KSSTREAM_POINTER 结构的指针，表示要前进以引用下一个可用数据帧的流指针。
返回值
KsStreamPointerAdvance 返回STATUS_SUCCESS以指示成功推进。 否则，它将返回错误代码。 STATUS_DEVICE_NOT_READY是最常返回的错误代码，通常表示在提升后锁定流指针失败。 换句话说， StreamPointer 引用队列中的最后一帧。
注解
如果在调用时 锁定 StreamPointer，AVStream 会在推进之前将其解锁。 高级后，流指针将重新置于其原始状态 (锁定或解锁) 在新帧上。
尝试推进已解锁的流指针始终会成功并返回STATUS_SUCCESS。 由于流指针未锁定，因此无法确定流指针是否引用实际数据。 微型驱动程序必须尝试锁定以确定新高级流指针是否引用数据帧。
另请参阅Stream指针。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | 适用于 Microsoft Windows XP 及更高版本的操作系统以及 DirectX 8.0 及更高版本的 DirectX。 |
| 目标平台 | 通用 |
| 标头 | ks.h (包括 Ks.h) |
| Library | Ks.lib |
| IRQL | <=DISPATCH_LEVEL |