Metodo IAVIStream::Read (vfw.h)

Articolo
08/27/2023

Il metodo Read legge i dati da un flusso e lo copia in un buffer definito dall'applicazione. Se non viene fornito alcun buffer, determina le dimensioni del buffer necessarie per recuperare il buffer successivo dei dati. Chiamato quando un'applicazione usa la funzione AVIStreamRead .

Sintassi

HRESULT Read(
  LONG   lStart,
  LONG   lSamples,
  LPVOID lpBuffer,
  LONG   cbBuffer,
  LONG   *plBytes,
  LONG   *plSamples
);

Parametri

lStart

Avvio del numero di esempio o di frame da leggere.

lSamples

Numero di esempi da leggere.

lpBuffer

Puntatore al buffer definito dall'applicazione per contenere i dati del flusso. È anche possibile specificare NULL per richiedere le dimensioni necessarie del buffer. Molte applicazioni precedono ogni operazione di lettura con una query per le dimensioni del buffer per verificare la dimensione di un buffer di grandi dimensioni.

cbBuffer

Dimensioni, in byte, del buffer specificato da lpBuffer.

plBytes

Puntatore a un buffer che riceve il numero di byte letti.

plSamples

Puntatore a un buffer che riceve il numero di campioni letti.

Valore restituito

Restituisce AVIERR_OK se ha esito positivo o AVIERR_BUFFERTOOSMALL se il buffer non è abbastanza grande per contenere i dati. In caso di esito positivo, Read restituisce anche un buffer di dati con il numero di fotogrammi (esempi) inclusi nel buffer o nella dimensione del buffer necessaria, in byte.

Commenti

Per i gestori scritti in C++, Read ha la sintassi seguente:


HRESULT Read(LONG lStart, LONG lSamples, 
    LPVOID lpBuffer, LONG cbBuffer, 
    LONG *plBytes, LONG *plSamples);

Requisiti


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

Vedi anche

Interfacce del gestore di flusso e file personalizzati

Gestori di file e flusso personalizzati

Condividi tramite