Fungsi GetWinMetaFileBits (wingdi.h)
Fungsi GetWinMetaFileBits mengonversi rekaman format yang disempurnakan dari metafile ke dalam rekaman berformat Windows dan menyimpan rekaman yang dikonversi dalam buffer yang ditentukan.
Sintaks
UINT GetWinMetaFileBits(
[in] HENHMETAFILE hemf,
[in] UINT cbData16,
[out] LPBYTE pData16,
[in] INT iMapMode,
[in] HDC hdcRef
);
Parameter
[in] hemf
Handel ke metafile yang ditingkatkan.
[in] cbData16
Ukuran, dalam byte, dari buffer tempat rekaman yang dikonversi akan disalin.
[out] pData16
Penunjuk ke buffer yang menerima rekaman yang dikonversi. Jika lpbBufferADALAH NULL, GetWinMetaFileBits mengembalikan jumlah byte yang diperlukan untuk menyimpan rekaman metafile yang dikonversi.
[in] iMapMode
Mode pemetaan yang akan digunakan dalam metafile yang dikonversi.
[in] hdcRef
Handel ke konteks perangkat referensi.
Menampilkan nilai
Jika fungsi berhasil dan penunjuk buffer adalah NULL, nilai yang dikembalikan adalah jumlah byte yang diperlukan untuk menyimpan rekaman yang dikonversi; jika fungsi berhasil dan penunjuk buffer adalah penunjuk yang valid, nilai yang dikembalikan adalah ukuran data metafile dalam byte.
Jika fungsi gagal, nilai yang dikembalikan adalah nol.
Keterangan
Fungsi ini mengonversi metafile yang disempurnakan menjadi metafile format Windows sehingga gambarnya dapat ditampilkan dalam aplikasi yang mengenali format yang lebih lama.
Sistem menggunakan konteks perangkat referensi untuk menentukan resolusi metafile yang dikonversi.
Fungsi GetWinMetaFileBits tidak membatalkan handel metafile yang ditingkatkan. Aplikasi harus memanggil fungsi DeleteEnhMetaFile untuk melepaskan handel saat tidak lagi diperlukan.
Untuk membuat metafile format Windows yang dapat diskalakan, tentukan MM_ANISOTROPIC sebagai parameter fnMapMode .
Sudut kiri atas gambar metafile selalu dipetakan ke asal perangkat referensi.
Persyaratan
| 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 |