Fonction DrvCreateDeviceBitmap (winddi.h)
La fonction DrvCreateDeviceBitmap crée et gère des bitmaps.
Syntaxe
HBITMAP DrvCreateDeviceBitmap(
DHPDEV dhpdev,
SIZEL sizl,
ULONG iFormat
);
Paramètres
dhpdev
Handle vers le PDEV qui décrit l’appareil physique qu’une application a désigné comme cible principale pour une bitmap. Le format de la bitmap doit être compatible avec cet appareil physique.
sizl
Spécifie une structure SIZEL qui contient la largeur et la hauteur de la bitmap à créer. Les membres cx et cy de cette structure contiennent respectivement, la largeur et la hauteur de la bitmap, en pixels. Une structure SIZEL est identique à une structure SIZE .
iFormat
Spécifie le format bitmap, qui indique le nombre requis de bits d’informations de couleur par pixel et correspond toujours au format de la base de données primaire. Cette valeur peut être l'une des suivantes :
| Valeur | Signification |
|---|---|
| BMF_8BPP | 8 bits par pixel. |
| BMF_16BPP | 16 bits par pixel. |
| BMF_24BPP | 24 bits par pixel. |
| BMF_32BPP | 32 bits par pixel. |
Valeur retournée
La valeur de retour est un handle qui identifie la bitmap créée si la fonction réussit. Si le pilote choisit de laisser GDI créer et gérer la bitmap, la valeur de retour est zéro. Si une erreur se produit, la valeur de retour est 0xFFFFFFFF et GDI enregistre un code d’erreur.
Remarques
Si le pilote crée la bitmap, il peut la stocker n’importe où et dans n’importe quel format. Il est supposé que le pilote prendra en compte les spécifications des paramètres et fournira une bitmap avec au moins autant de bits par pixel que demandé.
Le contenu de la bitmap créée n’est pas défini.
Cette fonction est facultative. Toutefois, si cette fonction est implémentée, DrvDeleteDeviceBitmap doit également être implémenté.
Configuration requise
| Plateforme cible | Bureau |
| En-tête | winddi.h (inclure Winddi.h) |