GetEnhMetaFilePixelFormat, fonction (wingdi.h)
La fonction GetEnhMetaFilePixelFormat récupère les informations de format de pixel pour un métafichier amélioré.
Syntaxe
UINT GetEnhMetaFilePixelFormat(
HENHMETAFILE hemf,
UINT cbBuffer,
PIXELFORMATDESCRIPTOR *ppfd
);
Paramètres
hemf
Identifie le métafichier amélioré.
cbBuffer
Spécifie la taille, en octets, de la mémoire tampon dans laquelle les informations de format de pixel sont copiées.
ppfd
Pointeur vers une structure PIXELFORMATDESCRIPTOR qui contient la spécification de format de pixel logique. Le métafichier utilise cette structure pour enregistrer la spécification du format de pixel logique.
Valeur retournée
Si la fonction réussit et trouve un format de pixel, la valeur renvoyée est la taille du format de pixel du métafichier.
Si aucun format de pixel n’est présent, la valeur de retour est zéro.
Si une erreur se produit et que la fonction échoue, la valeur de retour est GDI_ERROR. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.
Remarques
Lorsqu’un métafichier amélioré spécifie un format de pixel dans sa structure ENHMETAHEADER et que le format de pixel tient dans la mémoire tampon, les informations de format de pixel sont copiées dans ppfd. Lorsque cbBuffer est trop petit pour contenir le format de pixel du métafichier, le format de pixel n’est pas copié dans la mémoire tampon. Dans les deux cas, la fonction retourne la taille du format de pixel du métafichier.
Pour plus d’informations sur l’enregistrement de métafichier et d’autres opérations, consultez Opérations de métafichier améliorées.
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 |
Bibliothèque | Gdi32.lib |
DLL | Gdi32.dll |