Função PlayMetaFileRecord (wingdi.h)

Artigo
08/27/2023

A função PlayMetaFileRecord reproduz um registro de meta-arquivo no formato Windows executando a função GDI (interface de dispositivo gráfico) contida nesse registro.

Nota Essa função é fornecida apenas para compatibilidade com metarquivos no formato Windows. Os meta-arquivos de formato aprimorado fornecem funcionalidade superior e são recomendados para novos aplicativos. A função correspondente para um metarquivo de formato aprimorado é PlayEnhMetaFileRecord.

Sintaxe

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

Parâmetros

[in] hdc

Um identificador para um contexto de dispositivo.

[in] lpHandleTable

Um ponteiro para uma estrutura HANDLETABLE que representa a tabela de identificadores para objetos GDI usados ao reproduzir o metarquivo.

[in] lpMR

Um ponteiro para o registro de metarquivo no formato windows.

[in] noObjs

O número de identificadores na tabela de identificadores.

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero.

Comentários

Para converter um metarquivo no formato windows em um meta-arquivo de formato aprimorado, use a função SetWinMetaFileBits .

Um aplicativo normalmente usa PlayMetaFileRecord em conjunto com a função EnumMetaFile para processar e reproduzir um metarquivo no formato windows um registro por vez.

Os parâmetros lpHandletable e nHandles devem ser idênticos aos passados para o procedimento de retorno de chamada EnumMetaFileProc por EnumMetaFile.

Se a função PlayMetaFileRecord não reconhecer um registro, ela ignorará o registro e retornará TRUE.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	wingdi.h (inclua Windows.h)
Biblioteca	Gdi32.lib
DLL	Gdi32.dll