Metodo IAVIStream::ReadFormat (vfw.h)
Il metodo ReadFormat ottiene informazioni di formato da un flusso. Riempie e restituisce una struttura con i dati in un buffer definito dall'applicazione. Se non viene fornito alcun buffer, determina le dimensioni del buffer necessarie per recuperare il buffer dei dati di formato. Chiamato quando un'applicazione usa la funzione AVIStreamReadFormat .
Sintassi
HRESULT ReadFormat(
LONG lPos,
LPVOID lpFormat,
LONG *lpcbFormat
);
Parametri
lPos
Posizione dell'esempio o del frame.
lpFormat
Puntatore al buffer per i dati di formato. Specificare NULL per richiedere le dimensioni necessarie del buffer.
lpcbFormat
Puntatore a un buffer che riceve le dimensioni, in byte, del buffer specificato da lpFormat. Quando questo metodo viene chiamato, il contenuto di questo parametro indica la dimensione del buffer specificato da lpFormat. Quando questo metodo restituisce il controllo all'applicazione, il contenuto di questo parametro specifica la quantità di dati letti o le dimensioni necessarie del buffer.
Valore restituito
Restituisce il valore HRESULT definito da OLE.
Commenti
Il tipo di dati archiviati in un flusso determina le informazioni di formato e la struttura che contiene le informazioni sul formato. Un gestore di flusso deve restituire tutte le informazioni di formato applicabili in questa struttura, incluse le informazioni sulla tavolozza quando il formato usa una tavolozza. Un gestore di flusso non deve restituire i dati di flusso con la struttura.
I gestori di flusso video standard forniscono informazioni di formato in una struttura BITMAPINFOHEADER . I gestori di flusso audio standard forniscono informazioni di formato in una struttura PCMWAVEFORMAT . Altri flussi di dati possono usare altre strutture che descrivono i dati del flusso.
Per i gestori scritti in C++, ReadFormat ha la sintassi seguente:
HRESULT ReadFormat(LONG lPos, LPVOID lpFormat,
LONG *lpcbFormat)
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 |