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

Voir aussi

ENHMETAHEADER

OpenGL sur Windows

PIXELFORMATDESCRIPTOR

Fonctions Windows