PlayMetaFileRecord-Funktion (wingdi.h)

Artikel
03/13/2024

Die PlayMetaFileRecord-Funktion gibt einen Metadateidatensatz im Windows-Format wieder, indem die in diesem Datensatz enthaltene GDI-Funktion (Graphics Device Interface) ausgeführt wird.

Hinweis Diese Funktion wird nur zur Kompatibilität mit Metadateien im Windows-Format bereitgestellt. Metadateien im erweiterten Format bieten überlegene Funktionen und werden für neue Anwendungen empfohlen. Die entsprechende Funktion für eine Metadatei im erweiterten Format ist PlayEnhMetaFileRecord.

Syntax

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

Parameter

[in] hdc

Ein Handle für einen Gerätekontext.

[in] lpHandleTable

Ein Zeiger auf eine HANDLETABLE-Struktur , die die Tabelle der Handles für GDI-Objekte darstellt, die beim Wiedergeben der Metadatei verwendet werden.

[in] lpMR

Ein Zeiger auf den Metadateidatensatz im Windows-Format.

[in] noObjs

Die Anzahl der Handles in der Handletabelle.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null.

Hinweise

Verwenden Sie die Funktion SetWinMetaFileBits , um eine Metadatei im Windows-Format in eine Metadatei im erweiterten Format zu konvertieren.

Eine Anwendung verwendet in der Regel PlayMetaFileRecord in Verbindung mit der EnumMetaFile-Funktion , um eine Metadatei im Windows-Format einen Datensatz nach dem anderen zu verarbeiten und wiederzugeben.

Die Parameter lpHandletable und nHandles müssen mit denen identisch sein, die von EnumMetaFileFile an die EnumMetaFileProc-Rückrufprozedur übergeben werden.

Wenn die PlayMetaFileRecord-Funktion einen Datensatz nicht erkennt, ignoriert sie den Datensatz und gibt TRUE zurück.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	wingdi.h (windows.h einschließen)
Bibliothek	Gdi32.lib
DLL	Gdi32.dll