Bagikan melalui

Fungsi MFCalculateBitmapImageSize (mfapi.h)

  • Artikel

Mengambil ukuran gambar untuk format video. Mengingat struktur BITMAPINFOHEADER , fungsi ini menghitung nilai yang benar dari anggota biSizeImage .

Sintaks

HRESULT MFCalculateBitmapImageSize(
  [in]  const BITMAPINFOHEADER *pBMIH,
  [in]  UINT32                 cbBufSize,
  [out] UINT32                 *pcbImageSize,
  [out] BOOL                   *pbKnown
);

Parameter

[in] pBMIH

Penunjuk ke struktur BITMAPINFOHEADER yang menjelaskan format.

[in] cbBufSize

Ukuran buffer pBMIH , dalam byte. Ukurannya mencakup masker warna atau entri palet yang mengikuti struktur BITMAPINFOHEADER .

[out] pcbImageSize

Menerima ukuran gambar, dalam byte.

[out] pbKnown

Menerima nilai TRUE jika fungsi mengenali format video. Jika tidak, menerima nilai FALSE. Parameter ini bisa NULL.

Menampilkan nilai

Fungsi mengembalikan HRESULT. Nilai yang mungkin termasuk, tetapi tidak terbatas pada, yang ada dalam tabel berikut.

Menampilkan kode Deskripsi
S_OK
 Fungsi berhasil.
E_INVALIDARG
 Struktur BITMAPINFOHEADER tidak valid, atau nilai cbBufSize terlalu kecil.

Keterangan

Sebelum memanggil fungsi ini, Anda harus mengatur setidaknya anggota struktur BITMAPINFOHEADER berikut:

  • biCompression
  • biBitCount
  • biWidth
  • biHeight
Selain itu, jika biCompressionBI_BITFIELDS, struktur BITMAPINFOHEADER harus diikuti oleh array masker warna.

Fungsi ini gagal jika struktur BITMAPINFOHEADER menjelaskan format yang bukan format video. Misalnya, gagal jika biCompressonBI_JPEG atau BI_PNG .

Fungsi ini tersedia pada platform berikut jika komponen yang dapat didistribusikan ulang Windows Media Format 11 SDK diinstal:

  • Windows XP dengan Paket Layanan 2 (SP2) dan yang lebih baru.
  • Windows XP Media Center Edition 2005 dengan KB900325 (Windows XP Media Center Edition 2005) dan KB925766 (Rollup Pembaruan Oktober 2006 untuk Windows XP Media Center Edition) terinstal.

Persyaratan

   
Klien minimum yang didukung Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2008 [hanya aplikasi desktop]
Target Platform Windows
Header mfapi.h
Pustaka Mfplat.lib
DLL Mfplat.dll

Lihat juga

Fungsi Media Foundation