_BITMAPINFOHEADER structure

La structure _BITMAPINFOHEADER définit le format d’une trame vidéo.

Syntaxe

typedef struct _tagBITMAPINFOHEADER {
  DWORD biSize;
  LONG  biWidth;
  LONG  biHeight;
  WORD  biPlanes;
  WORD  biBitCount;
  DWORD biCompression;
  DWORD biSizeImage;
  LONG  biXPelsPerMeter;
  LONG  biYPelsPerMeter;
  DWORD biClrUsed;
  DWORD biClrImportant;
} _BITMAPINFOHEADER;

Membres

biSize

Spécifie le nombre d’octets requis par la structure.

biWidth

Spécifie la largeur de la bitmap, en pixels.

biHeight

Spécifie la hauteur de la bitmap, en pixels. Si biHeight est positif, la bitmap est une DIB de bas en haut et son origine est le coin inférieur gauche. Si biHeight est négatif, la bitmap est une DIB de haut vers le bas et son origine est le coin supérieur gauche. Si biHeight est négatif, indiquant une DIB descendante, la biCompression doit être BI_RGB ou BI_BITFIELDS. Les DIB de haut vers le bas ne peuvent pas être compressés.

Biplans

Spécifie le nombre de plans pour l’appareil cible. Cette valeur doit être définie sur 1.

biBitCount

Spécifie le nombre de bits par pixel. Le membre biBitCount de la structure BITMAPINFOHEADER détermine le nombre de bits qui définissent chaque pixel et le nombre maximal de couleurs dans la bitmap. Ce membre doit être l’une des valeurs suivantes.

Valeur	Description
1	La bitmap est monochrome et le membre bmiColors contient deux entrées. Chaque bit du tableau bitmap représente un pixel. Si le bit est clair, le pixel est affiché avec la couleur de la première entrée dans la table bmiColors ; si le bit est défini, le pixel a la couleur de la deuxième entrée dans le tableau.
2	La bitmap a quatre valeurs de couleur possibles.
4	La bitmap a un maximum de 16 couleurs, et le membre bmiColors contient jusqu’à 16 entrées. Chaque pixel de la bitmap est représenté par un index 4 bits dans la table de couleurs. Par exemple, si le premier octet de la bitmap est 0x1F, l’octet représente deux pixels. Le premier pixel contient la couleur dans la deuxième entrée de tableau, et le second pixel contient la couleur dans la seizième entrée de tableau.
8	La bitmap a un maximum de 256 couleurs, et le membre bmiColors contient jusqu’à 256 entrées. Dans ce cas, chaque octet du tableau représente un seul pixel.
16	La bitmap a un maximum de 2^16 couleurs. Si le membre biCompression de BITMAPINFOHEADER est BI_RGB, le membre bmiColors est NULL. Chaque MOT dans le tableau bitmap représente un seul pixel. Les intensités relatives du rouge, du vert et du bleu sont représentées par 5 bits pour chaque composant de couleur. La valeur du bleu est dans les 5 bits les moins significatifs, suivi de 5 bits chacun pour le vert et le rouge. Le bit le plus significatif n’est pas utilisé. La table de couleurs bmiColors est utilisée pour optimiser les couleurs utilisées sur les appareils basés sur des palettes et doit contenir le nombre d’entrées spécifiées par le membre biClrUsed.
24	La bitmap a un maximum de 2^24 couleurs, et le membre bmiColors est NULL. Chaque triplet de 3 octets dans le tableau bitmap représente l’intensité relative du bleu, du vert et du rouge, respectivement, pour un pixel. La table de couleurs bmiColors est utilisée pour optimiser les couleurs utilisées sur les appareils basés sur des palettes et doit contenir le nombre d’entrées spécifiées par le membre biClrUsed.
32	La bitmap a un maximum de 2^32 couleurs. Si le membre biCompression est BI_RGB, le membre bmiColors est NULL. Chaque DWORD dans le tableau bitmap représente l’intensité relative du bleu, du vert et du rouge, respectivement, pour un pixel. L’octet élevé dans chaque DWORD n’est pas utilisé. La table de couleurs bmiColors est utilisée pour optimiser les couleurs utilisées sur les appareils basés sur des palettes et doit contenir le nombre d’entrées spécifiées par le membre biClrUsed.

biCompression

Spécifie le type de compression d’une bitmap de bas en haut compressée (les DIB de haut en bas ne peuvent pas être compressées). Ce membre peut être l’une des valeurs suivantes.

Valeur	Description
BI_RGB	Format non compressé.
BI_BITFIELDS	Spécifie que la bitmap n’est pas compressée et que la table de couleurs se compose de trois masques de couleur DWORD qui spécifient les composants rouge, vert et bleu, respectivement, de chaque pixel. Cela est valide lorsqu’il est utilisé avec des bitmaps 16-bpp et 32-bpp. Cette valeur est valide dans Microsoft Windows CE version 2.0 et ultérieures.

biSizeImage

Spécifie la taille de l’image, en octets. Cette valeur peut être définie sur zéro pour BI_RGB bitmaps.

biXPelsPerMeter

Spécifie la résolution horizontale, en pixels par mètre, de l’appareil cible pour la bitmap. Une application peut utiliser cette valeur pour sélectionner une bitmap dans un groupe de ressources qui correspond le mieux aux caractéristiques de l’appareil actuel.

biYPelsPerMeter

Spécifie la résolution verticale, en pixels par mètre, de l’appareil cible pour la bitmap.

biClrUsed

Spécifie le nombre d’index de couleurs dans la table de couleurs qui sont réellement utilisés par la bitmap. Si cette valeur est égale à zéro, la bitmap utilise le nombre maximal de couleurs correspondant à la valeur du membre biBitCount pour le mode de compression spécifié par biCompression.

biClrImportant

Spécifie le nombre d’index de couleur requis pour l’affichage de la bitmap. Si cette valeur est égale à zéro, toutes les couleurs sont requises.

Si biClrUsed est différent de zéro et que le membre biBitCount est inférieur à 16, le membre biClrUsed spécifie le nombre réel de couleurs que le moteur graphique ou le pilote de périphérique accède. Si biBitCount est égal ou supérieur à 16, le membre biClrUsed spécifie la taille de la table de couleurs utilisée pour optimiser les performances des palettes de couleurs système. Si biBitCount est égal à 16 ou 32, la palette de couleurs optimale démarre immédiatement après les trois masques DWORD.

Si la bitmap est une bitmap empaquetée (une bitmap dans laquelle le tableau bitmap suit immédiatement la structure _BITMAPINFOHEADER et est référencé par un pointeur unique), le membre biClrUsed doit être égal à zéro ou à la taille réelle de la table de couleurs.

Notes

Cette structure est contenue dans une structure _VIDEOINFOHEADER .

Spécifications

Condition requise	Valeur
En-tête	Wmdm.idl

Voir aussi

Structures

_VIDEOINFOHEADER