Metafile::PlayRecord method (gdiplusheaders.h)

The Metafile::PlayRecord method plays a metafile record.


Status PlayRecord(
  [in] EmfPlusRecordType recordType,
  [in] UINT              flags,
  [in] UINT              dataSize,
  [in] const BYTE        *data


[in] recordType

Type: EmfPlusRecordType

Element of the EmfPlusRecordType enumeration that specifies the type of metafile record to be played.

[in] flags

Type: UINT

Set of flags that specify attributes of the record to be played.

[in] dataSize

Type: UINT

Integer that specifies the number of bytes contained in the record data.

[in] data

Type: const BYTE*

Pointer to an array of bytes that contains the record data.

Return value

Type: Status

If the method succeeds, it returns Ok, which is an element of the Status enumeration.

If the method fails, it returns one of the other elements of the Status enumeration.


This method is used in conjunction with the EnumerateMetafile Methods method of the Graphics class. The EnumerateMetafile Methods method calls an application-defined callback function for each record in a specified metafile. The callback function can display each record (or selected records) by calling the Metafile::PlayRecord method.


Minimum supported client Windows XP, Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header gdiplusheaders.h (include Gdiplus.h)
Library Gdiplus.lib
DLL Gdiplus.dll

See also


EnumerateMetafile Methods

Loading and Displaying Metafiles