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 |