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

Vedi anche

Interfacce di gestione e file personalizzati Stream

Gestori di file e Stream personalizzati