Funzione KsStreamPointerAdvance (ks.h)
La funzione KsStreamPointerAdvance sposta 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 del 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 il blocco del puntatore di flusso dopo l'avanzamento non è riuscito. In altre parole, StreamPointer fa riferimento all'ultimo fotogramma nella coda.
Osservazioni
Se StreamPointer è bloccato in fase di chiamata, AVStream lo sblocca prima di avanzare. Una volta avanzato, il puntatore di flusso viene inserito nuovamente nello stato originale (bloccato o sbloccato) sul nuovo fotogramma.
Un tentativo di avanzare 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 o meno a un frame di dati.
Vedere anche puntatori di flusso.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Disponibile in Microsoft Windows XP e nei sistemi operativi successivi e in DirectX 8.0 e versioni successive di DirectX. |
| piattaforma di destinazione | Universale |
| intestazione | ks.h (include Ks.h) |
| libreria | Ks.lib |
| IRQL | <=DISPATCH_LEVEL |