Partager via

Fonction DrvCreateDeviceBitmap (winddi.h)

  • Article

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)

Voir aussi

DrvDeleteDeviceBitmap