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 |