Metodo IGetFrame::SetFormat (vfw.h)

Il metodo SetFormat imposta il formato dell'immagine decompressa dei fotogrammi estratti e, facoltativamente, fornisce un buffer per l'operazione di decompressione.

Sintassi

HRESULT SetFormat(
  LPBITMAPINFOHEADER lpbi,
  LPVOID             lpBits,
  int                x,
  int                y,
  int                dx,
  int                dy
);

Parametri

lpbi

Puntatore a una struttura BITMAPINFOHEADER che definisce il formato dell'immagine decompressa. È anche possibile specificare NULL o il valore ((LPBITMAPINFOHEADER) 1) per questo parametro. NULL fa sì che il decompressore scelga un formato appropriato per la modifica (in genere un formato di profondità dell'immagine a 24 bit). Il valore ((LPBITMAPINFOHEADER) 1) fa sì che il decompressore scelga un formato appropriato per la modalità di visualizzazione corrente.

lpBits

Puntatore a un buffer per contenere i dati dell'immagine decompressa. Specificare NULL per fare in modo che questo metodo allochi un buffer.

x

Coordinata x del rettangolo di destinazione all'interno del DIB specificato da lpbi. Questo parametro viene usato quando lpBits non è NULL.

y

Coordinata y del rettangolo di destinazione all'interno del DIB specificato da lpbi. Questo parametro viene usato quando lpBits non è NULL.

dx

Larghezza del rettangolo di destinazione. Questo parametro viene usato quando lpBits non è NULL.

dy

Altezza del rettangolo di destinazione. Questo parametro viene usato quando lpBits non è NULL.

Valore restituito

Restituisce NOERROR se ha esito positivo, E_OUTOFMEMORY se l'immagine decompressa è maggiore della dimensione del buffer o E_FAIL in caso contrario.

Commenti

I parametri x, y, dx e dy identificano la parte della bitmap specificata da lpbi elpBits che riceve l'immagine decompressa.

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

HRESULT SetFormat(LPBITMAPINFOHEADER lpbi, LPVOID lpBits, int x, 
    int y, int dx, int dy); 
 

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 di file personalizzati

Gestori di file e flussi personalizzati