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。 由于流指针未锁定,因此无法确定流指针是否引用实际数据。 微型驱动程序必须尝试锁定以确定新高级流指针是否引用数据帧。

另请参阅 流指针

要求

要求 价值
最低支持的客户端 Microsoft Windows XP 及更高版本的作系统以及 DirectX 8.0 及更高版本的 DirectX 版本中提供。
目标平台 普遍
标头 ks.h (包括 Ks.h)
Ks.lib
IRQL <=DISPATCH_LEVEL

另请参阅

KSSTREAM_POINTER

KsStreamPointerAdvanceOffsets

KsStreamPointerAdvanceOffsetsAndUnlock

KsStreamPointerLock

KsStreamPointerUnlock