Función KsStreamPointerAdvance (ks.h)

La función KsStreamPointerAdvance avanza un puntero de flujo a la siguiente trama de datos.

Sintaxis

KSDDKAPI NTSTATUS KsStreamPointerAdvance(
  [in] PKSSTREAM_POINTER StreamPointer
);

Parámetros

[in] StreamPointer

Puntero a una estructura de KSSTREAM_POINTER que representa el puntero de flujo para avanzar para hacer referencia a la siguiente trama de datos disponible.

Valor devuelto

KsStreamPointerAdvance devuelve STATUS_SUCCESS para indicar un avance correcto. Devuelve un código de error de lo contrario. STATUS_DEVICE_NOT_READY es el código de error que se devuelve con más frecuencia y a menudo indica que se bloquea el puntero de flujo después de un error de avance. En otras palabras, StreamPointer hace referencia al último fotograma de la cola.

Comentarios

Si StreamPointer está bloqueado en el momento de la llamada, AVStream lo desbloquea antes de avanzar. Una vez avanzado, el puntero de secuencia se coloca de nuevo en su estado original (bloqueado o desbloqueado) en el nuevo marco.

Un intento de avanzar en un puntero de secuencia que se desbloquea siempre se realiza correctamente y devuelve STATUS_SUCCESS. Dado que el puntero de secuencia no está bloqueado, no hay ninguna manera de determinar si el puntero de secuencia hace referencia a datos reales. El minidriver debe intentar un bloqueo para determinar si el puntero de flujo recién avanzado hace referencia a una trama de datos o no.

Consulte también Stream punteros.

Requisitos

Requisito	Value
Cliente mínimo compatible	Disponible en Microsoft Windows XP y en sistemas operativos posteriores y DirectX 8.0 y versiones posteriores de DirectX.
Plataforma de destino	Universal
Encabezado	ks.h (incluye Ks.h)
Library	Ks.lib
IRQL	<=DISPATCH_LEVEL

Consulte también

KSSTREAM_POINTER

KsStreamPointerAdvanceOffsets

KsStreamPointerAdvanceOffsetsAndUnlock

KsStreamPointerLock

KsStreamPointerUnlock