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(
  HDC                 hdc,
  LPHANDLETABLE       pht,
  CONST ENHMETARECORD *pmr,
  UINT                cht
);

Parameters

hdc

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

pht

TBD

pmr

TBD

cht

TBD

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

   
Windows version Windows 2000 Professional [desktop apps only] Windows 2000 Server [desktop apps only]
Target Platform Windows
Header wingdi.h (include Windows.h)
Library Gdi32.lib
DLL Gdi32.dll

See Also

EnumEnhMetaFile

Metafile Functions

Metafiles Overview

PlayEnhMetaFile