GetMetaFileBitsEx, fonction (wingdi.h)

Article
08/27/2023

La fonction GetMetaFileBitsEx récupère le contenu d’un métafichier au format Windows et les copie dans la mémoire tampon spécifiée.

Note Cette fonction est fournie uniquement pour la compatibilité avec les métafichiers au format Windows. Les métafichiers au format amélioré offrent des fonctionnalités supérieures et sont recommandés pour les nouvelles applications. La fonction correspondante pour un métafichier au format amélioré est GetEnhMetaFileBits.

Syntaxe

UINT GetMetaFileBitsEx(
  [in]  HMETAFILE hMF,
  [in]  UINT      cbBuffer,
  [out] LPVOID    lpData
);

Paramètres

[in] hMF

Handle d’un métafichier au format Windows.

[in] cbBuffer

Taille, en octets, de la mémoire tampon à recevoir les données.

[out] lpData

Pointeur vers une mémoire tampon qui reçoit les données du métafichier. La mémoire tampon doit être suffisamment grande pour contenir les données. Si lpvData a la valeur NULL, la fonction retourne le nombre d’octets requis pour contenir les données.

Valeur retournée

Si la fonction réussit et que le pointeur de la mémoire tampon est NULL, la valeur de retour est le nombre d’octets requis pour la mémoire tampon ; si la fonction réussit et que le pointeur de mémoire tampon est un pointeur valide, la valeur de retour est le nombre d’octets copiés.

Si la fonction échoue, la valeur de retour est égale à zéro.

Remarques

Une fois les bits de métafichier Windows récupérés, ils peuvent être utilisés pour créer un métafichier basé sur la mémoire en appelant la fonction SetMetaFileBitsEx .

La fonction GetMetaFileBitsEx n’invalide pas le handle de métafichier. Une application doit supprimer ce handle en appelant la fonction DeleteMetaFile .

Pour convertir un métafichier au format Windows en métafichier au format amélioré, utilisez la fonction SetWinMetaFileBits .

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	wingdi.h (inclure Windows.h)
Bibliothèque	Gdi32.lib
DLL	Gdi32.dll