Condividi tramite


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