Fonction DescribePixelFormat (wingdi.h)

Article
03/04/2024

La fonction DescribePixelFormat obtient des informations sur le format de pixel identifié par iPixelFormat de l’appareil associé à hdc. La fonction définit les membres de la structure PIXELFORMATDESCRIPTOR pointées vers ppfd avec ces données de format de pixel.

Syntaxe

int DescribePixelFormat(
  HDC                     hdc,
  int                     iPixelFormat,
  UINT                    nBytes,
  LPPIXELFORMATDESCRIPTOR ppfd
);

Paramètres

hdc

Spécifie le contexte de l’appareil.

iPixelFormat

Index qui spécifie le format de pixels. Les formats de pixels pris en charge par un contexte d’appareil sont identifiés par des index entiers de base unique positifs.

nBytes

Taille, en octets, de la structure pointée vers ppfd. La fonction DescribePixelFormat ne stocke pas plus de n Octets de données dans cette structure. Définissez cette valeur sur sizeof(PIXELFORMATDESCRIPTOR).

ppfd

Pointeur vers une structure PIXELFORMATDESCRIPTOR dont les membres de la fonction définissent des données au format pixel. La fonction stocke le nombre d’octets copiés dans la structure dans le membre nSize de la structure. Si, lors de l’entrée, ppfd a la valeur NULL, la fonction n’écrit aucune donnée dans la structure. Cela est utile lorsque vous souhaitez uniquement obtenir l’index de format de pixels maximal d’un contexte d’appareil.

Valeur retournée

Si la fonction réussit, la valeur de retour est l’index de format de pixels maximal du contexte de l’appareil. En outre, la fonction définit les membres de la structure PIXELFORMATDESCRIPTOR pointés par ppfd en fonction du format de pixel spécifié.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

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

Partager via