Structure DIBSECTION (wingdi.h)

  • Article

La structure DIBSECTION contient des informations sur une DIB créée en appelant la fonction CreateDIBSection . Une structure DIBSECTION inclut des informations sur les dimensions de la bitmap, le format de couleur, les masques de couleur, l’objet de mappage de fichiers facultatif et le décalage de stockage des valeurs de bits facultatifs. Une application peut obtenir une structure DIBSECTION remplie pour une DIB donnée en appelant la fonction GetObject .

Syntaxe

typedef struct tagDIBSECTION {
  BITMAP           dsBm;
  BITMAPINFOHEADER dsBmih;
  DWORD            dsBitfields[3];
  HANDLE           dshSection;
  DWORD            dsOffset;
} DIBSECTION, *LPDIBSECTION, *PDIBSECTION;

Membres

dsBm

Structure de données BITMAP qui contient des informations sur la DIB : son type, ses dimensions, ses capacités de couleur et un pointeur vers ses valeurs de bits.

dsBmih

Structure BITMAPINFOHEADER qui contient des informations sur le format de couleur de la DIB.

dsBitfields[3]

Spécifie trois masques de couleur pour la DIB. Ce champ n’est valide que lorsque le membre BitCount de la structure BITMAPINFOHEADER a une valeur supérieure à 8. Chaque masque de couleur indique les bits utilisés pour encoder l’un des trois canaux de couleur (rouge, vert et bleu).

dshSection

Contient un handle à l’objet de mappage de fichiers que la fonction CreateDIBSection a utilisé pour créer la DIB. Si CreateDIBSection a été appelé avec une valeur NULL pour son paramètre hSection , ce qui oblige le système à allouer de la mémoire pour la bitmap, le membre dshSection est NULL.

dsOffset

Décalage par rapport aux valeurs de bits de la bitmap dans l’objet de mappage de fichiers référencé par dshSection. Si dshSection a la valeur NULL, la valeur dsOffset n’a aucune signification.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
En-tête wingdi.h (inclure Windows.h)

Voir aussi

BITMAP

BITMAPINFOHEADER

Bitmap Structures

Vue d’ensemble des bitmaps

CreateDIBSection

GetDIBColorTable

Getobject