GetWinMetaFileBits, fonction (wingdi.h)

La fonction GetWinMetaFileBits convertit les enregistrements au format amélioré d’un métafichier en enregistrements au format Windows et stocke les enregistrements convertis dans la mémoire tampon spécifiée.

Syntaxe

UINT GetWinMetaFileBits(
  [in]  HENHMETAFILE hemf,
  [in]  UINT         cbData16,
  [out] LPBYTE       pData16,
  [in]  INT          iMapMode,
  [in]  HDC          hdcRef
);

Paramètres

[in] hemf

Handle du métafichier amélioré.

[in] cbData16

Taille, en octets, de la mémoire tampon dans laquelle les enregistrements convertis doivent être copiés.

[out] pData16

Pointeur vers la mémoire tampon qui reçoit les enregistrements convertis. Si lpbBuffer a la valeur NULL, GetWinMetaFileBits retourne le nombre d’octets requis pour stocker les enregistrements de métafichiers convertis.

[in] iMapMode

Mode de mappage à utiliser dans le métafichier converti.

[in] hdcRef

Handle du contexte de l’appareil de référence.

Valeur retournée

Si la fonction réussit et que le pointeur de la mémoire tampon est NULL, la valeur de retour correspond au nombre d’octets requis pour stocker les enregistrements convertis ; si la fonction réussit et que le pointeur de mémoire tampon est un pointeur valide, la valeur de retour correspond à la taille des données du métafichier en octets.

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

Remarques

Cette fonction convertit un métafichier amélioré en métafichier au format Windows afin que son image puisse être affichée dans une application qui reconnaît l’ancien format.

Le système utilise le contexte de l’appareil de référence pour déterminer la résolution du métafichier converti.

La fonction GetWinMetaFileBits n’invalide pas le handle de métafichier amélioré. Une application doit appeler la fonction DeleteEnhMetaFile pour libérer le handle lorsqu’il n’est plus nécessaire.

Pour créer un métafichier évolutif au format Windows, spécifiez MM_ANISOTROPIC comme paramètre fnMapMode .

Le coin supérieur gauche de l’image de métafichier est toujours mappé à l’origine de l’appareil de référence.

Configuration requise

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

DeleteEnhMetaFile

Fonctions de métafichier

Vue d’ensemble des métafichiers

SetMapMode

SetWinMetaFileBits