Función PlayMetaFileRecord (wingdi.h)

Artículo
08/27/2023

La función PlayMetaFileRecord reproduce un registro de metarchivo de formato Windows ejecutando la función de interfaz de dispositivo gráfico (GDI) contenida en ese registro.

Nota Esta función solo se proporciona para la compatibilidad con metarchivos de formato Windows. Los metarchivos de formato mejorado proporcionan una funcionalidad superior y se recomiendan para las nuevas aplicaciones. La función correspondiente para un metarchivo de formato mejorado es PlayEnhMetaFileRecord.

Sintaxis

BOOL PlayMetaFileRecord(
  [in] HDC           hdc,
  [in] LPHANDLETABLE lpHandleTable,
  [in] LPMETARECORD  lpMR,
  [in] UINT          noObjs
);

Parámetros

[in] hdc

Identificador de un contexto de dispositivo.

[in] lpHandleTable

Puntero a una estructura HANDLETABLE que representa la tabla de identificadores a objetos GDI usados al reproducir el metarchivo.

[in] lpMR

Puntero al registro de metarchivo de formato Windows.

[in] noObjs

Número de identificadores de la tabla de identificadores.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero.

Comentarios

Para convertir un metarchivo de formato Windows en un metarchivo de formato mejorado, use la función SetWinMetaFileBits .

Normalmente, una aplicación usa PlayMetaFileRecord junto con la función EnumMetaFile para procesar y reproducir un metarchivo de formato Windows un registro cada vez.

Los parámetros lpHandletable y nHandles deben ser idénticos a los pasados al procedimiento de devolución de llamada EnumMetaFileProc por EnumMetaFile.

Si la función PlayMetaFileRecord no reconoce un registro, omite el registro y devuelve TRUE.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	wingdi.h (incluye Windows.h)
Library	Gdi32.lib
Archivo DLL	Gdi32.dll