Fungsi PlayMetaFileRecord (wingdi.h)

Artikel
03/04/2024

Fungsi PlayMetaFileRecord memutar rekaman metafile format Windows dengan menjalankan fungsi antarmuka perangkat grafis (GDI) yang terkandung dalam rekaman tersebut.

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

Sintaks

BOOL PlayMetaFileRecord(
  [in] HDC           hdc,
  [in] LPHANDLETABLE lpHandleTable,
  [in] LPMETARECORD  lpMR,
  [in] UINT          noObjs
);

Parameter

[in] hdc

Handel ke konteks perangkat.

[in] lpHandleTable

Penunjuk ke struktur HANDLETABLE yang mewakili tabel handel ke objek GDI yang digunakan saat memutar metafile.

[in] lpMR

Penunjuk ke rekaman metafile format Windows.

[in] noObjs

Jumlah handel dalam tabel handel.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol.

Keterangan

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

Aplikasi biasanya menggunakan PlayMetaFileRecord bersama dengan fungsi EnumMetaFile untuk memproses dan memutar rekaman metafile format Windows satu per satu.

Parameter lpHandletable dan nHandles harus identik dengan yang diteruskan ke prosedur panggilan balik EnumMetaFileProc oleh EnumMetaFile.

Jika fungsi PlayMetaFileRecord tidak mengenali rekaman, fungsi tersebut mengabaikan rekaman dan mengembalikan TRUE.

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