// ks.h
KSDDKAPI NTSTATUS KsStreamPointerAdvance(
[in] PKSSTREAM_POINTER StreamPointer
);
View the official Windows Driver Kit DDI reference
No description available.
The KsStreamPointerAdvance function advances a stream pointer to the next data frame.
StreamPointer
[in]A pointer to a KSSTREAM_POINTER structure representing the stream pointer to advance to reference the next available data frame.
KsStreamPointerAdvance returns STATUS_SUCCESS to indicate a successful advancement. It returns an error code otherwise. STATUS_DEVICE_NOT_READY is the most often returned error code and often indicates that locking the stream pointer after advancement failed. In other words, StreamPointer references the last frame in the queue.
If StreamPointer is locked at call-time, AVStream unlocks it before advancing it. Once advanced, the stream pointer is placed back into its original state (locked or unlocked) on the new frame.
An attempt to advance a stream pointer that is unlocked always succeeds and returns STATUS_SUCCESS. Since the stream pointer is not locked, there is no way to determine if the stream pointer references actual data. The minidriver must attempt a lock to determine if the newly advanced stream pointer references a data frame or not.
Also see Stream Pointers.
KsStreamPointerAdvanceOffsetsAndUnlock