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 |