Partager via


GetMetaFileBitsEx, fonction (wingdi.h)

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

Voir aussi

DeleteMetaFile

GetEnhMetaFileBits

Fonctions de métafichier

Vue d’ensemble des métafichiers

SetMetaFileBitsEx

SetWinMetaFileBits