| BOOL PlayEnhMetaFileRecord(hdc, lpHandletable, lpEnhMetaRecord, nHandles) | |||||
| HDC hdc; | /* handle of device context | */ | |||
| LPHANDLETABLE lpHandletable; | /* address of metafile handle-table | */ | |||
| LPENHMETARECORD lpEnhMetaRecord; | /* address of metafile record | */ | |||
| UINT nHandles; | /* count of handles | */ | |||
The PlayEnhMetaFileRecord function plays an enhanced-metafile record by executing the GDI calls that are identified by the record.
hdc
Identifies the device context that was passed to EnumEnhMetaFile.
lpHandletable
Points to the object handle-table to be used for the enhanced metafile playback. The first entry in this table contains the enhanced metafile handle.
lpEnhMetaRecord
Points to the enhanced-metafile record to be played.
nHandles
Specifies the number of handles in the handle table.
The return value is TRUE if the function is successful. Otherwise, it is FALSE.
This is an enhanced metafile function.
This function should be called by the EnumEnhMetaFileProc function to play a metafile one record at a time.
The hdc, lpHandletable, and nHandles parameters must be exactly those passed to the EnhMetaFunc callback procedure by EnumEnhMetaFile.
If the PlayEnhMetaFileRecord function does not recognize a record, it will ignore the record and return TRUE. If the hdc parameter refers to a device context for an enhanced metafile, the unrecognized record will be embedded in the enhanced metafile without modification.
EnumEnhMetaFile, PlayEnhMetaFile