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 |
|---|---|
|
La dimensione del buffer cbBuffer è minore di un singolo esempio di dati. |
|
Memoria insufficiente per completare l'operazione di lettura. |
|
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 |