CreateBitmapIndirect, fonction (wingdi.h)

Article
08/27/2023

La fonction CreateBitmapIndirect crée une bitmap avec la largeur, la hauteur et le format de couleur spécifiés (plans de couleurs et bits par pixel).

Syntaxe

HBITMAP CreateBitmapIndirect(
  [in] const BITMAP *pbm
);

Paramètres

[in] pbm

Pointeur vers une structure BITMAP qui contient des informations sur l’image bitmap. Si une application définit les membres bmWidth ou bmHeight sur zéro, CreateBitmapIndirect retourne le handle à un bitmap monochrome de 1 pixel sur 1.

Valeur retournée

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

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

Cette fonction peut retourner les valeurs suivantes.

Code de retour	Description
ERROR_INVALID_PARAMETER	Un ou plusieurs des paramètres d’entrée n’est pas valide.
ERROR_NOT_ENOUGH_MEMORY	La bitmap est trop grande pour que la mémoire soit allouée.

Remarques

La fonction CreateBitmapIndirect crée une bitmap dépendante de l’appareil.

Une fois qu’une bitmap est créée, elle peut être sélectionnée dans un contexte d’appareil en appelant la fonction SelectObject . Toutefois, la bitmap ne peut être sélectionnée dans un contexte d’appareil que si la bitmap et le contrôleur de domaine ont le même format.

Bien que la fonction CreateBitmapIndirect puisse être utilisée pour créer des bitmaps de couleur, pour des raisons de performances, les applications doivent utiliser CreateBitmapIndirect pour créer des bitmaps monochromes et CreateCompatibleBitmap pour créer des bitmaps de couleur. Chaque fois qu’une image bitmap de couleur de CreateBitmapIndirect est sélectionnée dans un contexte d’appareil, le système doit s’assurer que la bitmap correspond au format du contexte d’appareil dans lequel elle est sélectionnée. Étant donné que CreateCompatibleBitmap prend un contexte d’appareil, il retourne une bitmap qui a le même format que le contexte d’appareil spécifié. Ainsi, les appels ultérieurs à SelectObject sont plus rapides avec une bitmap de couleur à partir de CreateCompatibleBitmap qu’avec une bitmap de couleur retournée à partir de CreateBitmapIndirect.

Si l’image bitmap est monochrome, les zéros représentent la couleur de premier plan et les autres représentent la couleur d’arrière-plan du contexte de l’appareil de destination.

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

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