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