Metodo IAVIStream::Read (vfw.h)
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 |