Metode IGetFrame::SetFormat (vfw.h)

Metode SetFormat mengatur format gambar yang didekompresi dari bingkai yang diekstrak dan secara opsional menyediakan buffer untuk operasi dekompresi.

Sintaks

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

Parameter

lpbi

Penunjuk ke struktur BITMAPINFOHEADER yang menentukan format gambar yang didekompresi. Anda juga dapat menentukan NULL atau nilai ((LPBITMAPINFOHEADER) 1) untuk parameter ini. NULL menyebabkan dekompresor memilih format yang sesuai untuk pengeditan (biasanya format kedalaman gambar 24-bit). Nilai ((LPBITMAPINFOHEADER) 1) menyebabkan dekompresor memilih format yang sesuai untuk mode tampilan saat ini.

lpBits

Arahkan ke buffer untuk berisi data gambar yang didekompresi. Tentukan NULL agar metode ini mengalokasikan buffer.

x

Koordinat x persegi panjang tujuan dalam DIB yang ditentukan oleh lpbi. Parameter ini digunakan ketika lpBits bukan NULL.

y

Koordinat y persegi panjang tujuan dalam DIB yang ditentukan oleh lpbi. Parameter ini digunakan ketika lpBits bukan NULL.

dx

Lebar persegi panjang tujuan. Parameter ini digunakan ketika lpBits bukan NULL.

dy

Tinggi persegi panjang tujuan. Parameter ini digunakan ketika lpBits bukan NULL.

Mengembalikan nilai

Mengembalikan NOERROR jika berhasil, E_OUTOFMEMORY jika gambar yang didekompresi lebih besar dari ukuran buffer, atau E_FAIL sebaliknya.

Keterangan

Parameter x, y, dx, dan dy mengidentifikasi bagian bitmap yang ditentukan oleh lpbi dan lpBits yang menerima gambar yang didekompresi.

Untuk handler yang ditulis dalam C++, SetFormat memiliki sintaks berikut:

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

Persyaratan

Lihat juga

Antarmuka Penangan File dan Aliran Kustom

Penangan File dan Aliran Kustom