Funzione KsStreamPointerAdvance (ks.h)

La funzione KsStreamPointerAdvance avanza un puntatore di flusso al frame di dati successivo.

Sintassi

KSDDKAPI NTSTATUS KsStreamPointerAdvance(
  [in] PKSSTREAM_POINTER StreamPointer
);

Parametri

[in] StreamPointer

Puntatore a una struttura KSSTREAM_POINTER che rappresenta il puntatore di flusso per passare al frame di dati disponibile successivo.

Valore restituito

KsStreamPointerAdvance restituisce STATUS_SUCCESS per indicare un avanzamento riuscito. Restituisce un codice di errore in caso contrario. STATUS_DEVICE_NOT_READY è il codice di errore più spesso restituito e spesso indica che bloccando il puntatore di flusso dopo l'avanzamento non riuscito. In altre parole, StreamPointer fa riferimento all'ultimo frame nella coda.

Commenti

Se StreamPointer è bloccato in fase di chiamata, AVStream lo sblocca prima di avanzare. Una volta avanzate, il puntatore di flusso viene inserito nello stato originale (bloccato o sbloccato) nel nuovo frame.

Un tentativo di avanzamento di un puntatore di flusso sbloccato ha sempre esito positivo e restituisce STATUS_SUCCESS. Poiché il puntatore di flusso non è bloccato, non è possibile determinare se il puntatore di flusso fa riferimento ai dati effettivi. Il minidriver deve tentare un blocco per determinare se il puntatore di flusso avanzato fa riferimento a un frame di dati o meno.

Vedere anche Stream Puntatori.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile in Microsoft Windows XP e versioni successive e DirectX 8.0 e versioni successive di DirectX.
Piattaforma di destinazione	Universale
Intestazione	ks.h (include Ks.h)
Libreria	Ks.lib
IRQL	<=DISPATCH_LEVEL

Vedi anche

KSSTREAM_POINTER

KsStreamPointerAdvanceOffsets

KsStreamPointerAdvanceOffsetsAndUnlock

KsStreamPointerLock

KsStreamPointerUnlock