Fungsi GetMetaFileBitsEx (wingdi.h)

Artikel
03/04/2024

Fungsi GetMetaFileBitsEx mengambil konten metafile format Windows dan menyalinnya ke dalam buffer yang ditentukan.

Catatan Fungsi ini disediakan hanya untuk kompatibilitas dengan metafil format Windows. Metafil format yang disempurnakan menyediakan fungsionalitas yang unggul dan direkomendasikan untuk aplikasi baru. Fungsi yang sesuai untuk metafile format yang disempurnakan adalah GetEnhMetaFileBits.

Sintaks

UINT GetMetaFileBitsEx(
  [in]  HMETAFILE hMF,
  [in]  UINT      cbBuffer,
  [out] LPVOID    lpData
);

Parameter

[in] hMF

Handel ke metafile format Windows.

[in] cbBuffer

Ukuran, dalam byte, dari buffer untuk menerima data.

[out] lpData

Penunjuk ke buffer yang menerima data metafile. Buffer harus cukup besar untuk memuat data. Jika lpvData adalah NULL, fungsi mengembalikan jumlah byte yang diperlukan untuk menyimpan data.

Nilai kembali

Jika fungsi berhasil dan penunjuk buffer adalah NULL, nilai yang dikembalikan adalah jumlah byte yang diperlukan untuk buffer; jika fungsi berhasil dan penunjuk buffer adalah penunjuk yang valid, nilai yang dikembalikan adalah jumlah byte yang disalin.

Jika fungsi gagal, nilai yang dikembalikan adalah nol.

Keterangan

Setelah bit Windows-metafile diambil, bit tersebut dapat digunakan untuk membuat metafile berbasis memori dengan memanggil fungsi SetMetaFileBitsEx .

Fungsi GetMetaFileBitsEx tidak membatalkan handel metafile. Aplikasi harus menghapus handel ini dengan memanggil fungsi DeleteMetaFile .

Untuk mengonversi metafile format Windows menjadi metafile format yang disempurnakan, gunakan fungsi SetWinMetaFileBits .

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	wingdi.h (sertakan Windows.h)
Pustaka	Gdi32.lib
DLL	Gdi32.dll