Fonction DrvDescribePixelFormat (winddi.h)

La fonction DrvDescribePixelFormat décrit le format de pixel pour un PDEV spécifié par l’appareil en écrivant une description de format de pixel dans une structure PIXELFORMATDESCRIPTOR.

Syntaxe

LONG DrvDescribePixelFormat(
  DHPDEV                dhpdev,
  LONG                  iPixelFormat,
  ULONG                 cjpfd,
  PIXELFORMATDESCRIPTOR *ppfd
);

Paramètres

dhpdev

Identifie l’appareil pour lequel les informations de format de pixel sont demandées.

iPixelFormat

Spécifie le numéro d’index du format de pixel demandé.

cjpfd

Spécifie le nombre maximal d’octets pouvant être écrits dans la structure pointée par ppfd.

ppfd

Pointeur vers une structure PIXELFORMATDESCRIPTOR (décrite dans la documentation Microsoft Windows SDK) qui doit recevoir des informations sur le format de pixel. Ce paramètre peut être NULL.

Valeur retournée

La valeur de retour est l’index de format de pixel maximal si la fonction réussit. Sinon, il est égal à zéro et un code d’erreur est journalisé.

Remarques

Un pilote d’affichage qui prend en charge le matériel graphique 3D peut prendre en charge les fenêtres avec différents formats de pixels sur une même surface d’affichage. Le format de pixel doit correspondre à une configuration prise en charge par le matériel graphique.

DrvDescribePixelFormat remplit la structure pointée par ppfd si ce paramètre n’est pas NULL.

L’index de format de pixel maximal retourné peut être utilisé par les applications qui doivent obtenir l’index de format de pixel maximal d’un contexte d’appareil. Les formats de pixels pris en charge par un appareil sont identifiés par des index d’entiers de base unique positifs.

Les fonctions de format de pixel sont utilisées conjointement avec les fonctions des services d’objets de fenêtre pour suivre et mettre à jour les formats de pixels des fenêtres sur une surface d’affichage.

Configuration requise

Plateforme cible	Bureau
En-tête	winddi.h (inclure Winddi.h)