Metafile::PlayRecord method (gdiplusheaders.h)

Article
10/13/2021

The Metafile::PlayRecord method plays a metafile record.

Syntax

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

Parameters

[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.

Remarks

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.

Requirements

Requirement	Value
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