Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

PlayEnhMetaFileRecord function

The PlayEnhMetaFileRecord function plays an enhanced-metafile record by executing the graphics device interface (GDI) functions identified by the record.

Syntax


BOOL PlayEnhMetaFileRecord(
  _In_       HDC           hdc,
  _In_       LPHANDLETABLE lpHandletable,
  _In_ const ENHMETARECORD *lpEnhMetaRecord,
  _In_       UINT          nHandles
);

Parameters

hdc [in]

A handle to the device context passed to the EnumEnhMetaFile function.

lpHandletable [in]

A pointer to a table of handles to GDI objects used when playing the metafile. The first entry in this table contains the enhanced-metafile handle.

lpEnhMetaRecord [in]

A pointer to the enhanced-metafile record to be played.

nHandles [in]

The number of handles in the handle table.

Return value

If the function succeeds, the return value is nonzero.

If the function fails, the return value is zero.

Remarks

This is an enhanced-metafile function.

An application typically uses PlayEnhMetaFileRecord in conjunction with the EnumEnhMetaFile function to process and play an enhanced-format metafile one record at a time.

The hdc, lpHandletable, and nHandles parameters must be exactly those passed to the EnhMetaFileProc callback procedure by the EnumEnhMetaFile function.

If PlayEnhMetaFileRecord does not recognize a record, it ignores the record and returns TRUE.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Wingdi.h (include Windows.h)

Library

Gdi32.lib

DLL

Gdi32.dll

See also

Metafiles Overview
Metafile Functions
EnumEnhMetaFile
PlayEnhMetaFile

 

 

Show: