Funzione AVIStreamRead (vfw.h)

La funzione AVIStreamRead legge audio, video o altri dati da un flusso in base al tipo di flusso.

Sintassi

HRESULT AVIStreamRead(
  PAVISTREAM pavi,
  LONG       lStart,
  LONG       lSamples,
  LPVOID     lpBuffer,
  LONG       cbBuffer,
  LONG       *plBytes,
  LONG       *plSamples
);

Parametri

pavi

Gestire in un flusso aperto.

lStart

Primo esempio da leggere.

lSamples

Numero di esempi da leggere. È anche possibile specificare il valore AVISTREAMREAD_CONVENIENT per consentire al gestore di flusso di determinare il numero di esempi da leggere.

lpBuffer

Puntatore a un buffer per contenere i dati.

cbBuffer

Dimensioni, in byte, del buffer a cui punta lpBuffer.

plBytes

Puntatore a un buffer che riceve il numero di byte di dati scritti nel buffer a cui fa riferimento lpBuffer. Questo valore può essere NULL.

plSamples

Puntatore a un buffer che riceve il numero di campioni scritti nel buffer a cui fa riferimento lpBuffer. Questo valore può essere NULL.

Valore restituito

Restituisce zero se ha esito positivo o un errore in caso contrario. I valori di errore possibili includono quanto segue.

Codice restituito	Descrizione
AVIERR_BUFFERTOOSMALL	La dimensione del buffer cbBuffer è minore di un singolo esempio di dati.
AVIERR_MEMORY	Memoria insufficiente per completare l'operazione di lettura.
AVIERR_FILEREAD	Si è verificato un errore del disco durante la lettura del file.

Commenti

Se lpBuffer è NULL, questa funzione non legge dati; restituisce informazioni sulle dimensioni dei dati letti.

L'argomento pavi è un puntatore a un'interfaccia IAVIStream .

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	vfw.h
Libreria	Vfw32.lib
DLL	Avifil32.dll

Vedi anche

Funzioni AVIFile

Funzioni e macro AVIFile