CreateDIBitmap, fonction (wingdi.h)

Article
08/27/2023

La fonction CreateDIBitmap crée un bitmap compatible (DDB) à partir d’une DIB et, éventuellement, définit les bits bitmap.

Syntaxe

HBITMAP CreateDIBitmap(
  [in] HDC                    hdc,
  [in] const BITMAPINFOHEADER *pbmih,
  [in] DWORD                  flInit,
  [in] const VOID             *pjBits,
  [in] const BITMAPINFO       *pbmi,
  [in] UINT                   iUsage
);

Paramètres

[in] hdc

Handle d'un contexte de périphérique.

[in] pbmih

Pointeur vers une structure d’en-tête d’informations bitmap , BITMAPV5HEADER.

Si fdwInit est CBM_INIT, la fonction utilise la structure d’en-tête d’informations bitmap pour obtenir la largeur et la hauteur souhaitées de la bitmap, ainsi que d’autres informations. Notez qu’une valeur positive pour la hauteur indique une DIB ascendante tandis qu’une valeur négative pour la hauteur indique une DIB de haut en bas. Appeler CreateDIBitmap avec fdwInit comme CBM_INIT revient à appeler la fonction CreateCompatibleBitmap pour créer une DDB au format de l’appareil, puis à appeler la fonction SetDIBits pour traduire les bits DIB en DDB.

[in] flInit

Spécifie la façon dont le système initialise les bits bitmap. La valeur suivante est définie.

Valeur	Signification
CBM_INIT	Si cet indicateur est défini, le système utilise les données pointées par les paramètres lpbInit et lpbmi pour initialiser les bits bitmap. Si cet indicateur est clair, les données pointées par ces paramètres ne sont pas utilisées.

Si fdwInit est égal à zéro, le système n’initialise pas les bits bitmap.

[in] pjBits

Pointeur vers un tableau d’octets contenant les données bitmap initiales. Le format des données dépend du membre biBitCount de la structure BITMAPINFO vers laquelle pointe le paramètre lpbmi .

[in] pbmi

Pointeur vers une structure BITMAPINFO qui décrit les dimensions et le format de couleur du tableau vers lequel pointe le paramètre lpbInit .

[in] iUsage

Spécifie si le membre bmiColors de la structure BITMAPINFO a été initialisé et, le cas échéant, si bmiColors contient des valeurs rouges, vertes, bleues (RVB) explicites ou des index de palette. Le paramètre fuUsage doit être l’une des valeurs suivantes.

Valeur	Signification
DIB_PAL_COLORS	Une table de couleurs est fournie et se compose d’un tableau d’index 16 bits dans la palette logique du contexte d’appareil dans lequel la bitmap doit être sélectionnée.
DIB_RGB_COLORS	Une table de couleurs est fournie et contient des valeurs RVB littérales.

Valeur retournée

Si la fonction réussit, la valeur de retour est un handle pour l’image bitmap compatible.

Si la fonction échoue, la valeur de retour est NULL.

Remarques

La base de données DDB créée correspond à la profondeur de bits de votre contrôleur de domaine de référence. Pour créer une bitmap de profondeur de bits différente, utilisez CreateDIBSection.

Pour qu’un appareil atteigne une vitesse de dessin bitmap optimale, spécifiez fdwInit comme CBM_INIT. Ensuite, utilisez la même DIB de profondeur de couleur que le mode vidéo. Lorsque la vidéo exécute 4 ou 8 bpp, utilisez DIB_PAL_COLORS.

L’indicateur CBM_CREATDIB pour le paramètre fdwInit n’est plus pris en charge.

Lorsque vous n’avez plus besoin de la bitmap, appelez la fonction DeleteObject pour la supprimer.

ICM: Aucune gestion des couleurs n’est effectuée. Le contenu de l’image bitmap résultante n’est pas mis en correspondance de couleur une fois la bitmap créée.

Configuration requise


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 (inclure Windows.h)
Bibliothèque	Gdi32.lib
DLL	Gdi32.dll