_BITMAPINFOHEADER Struktur

Die _BITMAPINFOHEADER Struktur definiert das Format eines Videoframes.

Syntax

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;

Member

biSize

Gibt die Anzahl der Byte an, die von der Struktur benötigt werden.

biWidth

Gibt die Breite der Bitmap in Pixeln an.

biHeight

Gibt die Höhe der Bitmap in Pixeln an. Wenn biHeight positiv ist, ist die Bitmap ein bottom-up DIB, und der Ursprung ist die untere linke Ecke. Wenn biHeight negativ ist, ist die Bitmap ein top-down DIB, und der Ursprung ist die obere linke Ecke. Wenn biHeight negativ ist, muss biCompression entweder BI_RGB oder BI_BITFIELDS sein. Top-down-DIBs können nicht komprimiert werden.

Doppeldecker

Gibt die Anzahl der Ebenen für das Zielgerät an. Dieser Wert muss auf 1 festgelegt werden.

biBitCount

Gibt die Anzahl der Bits pro Pixel an. Das biBitCount-Element der BITMAPINFOHEADER-Struktur bestimmt die Anzahl der Bits, die jedes Pixel und die maximale Anzahl von Farben in der Bitmap definieren. Dieses Element muss eine der folgenden Werte sein.

Wert	BESCHREIBUNG
1	Die Bitmap ist monochrom, und das Element "bmiColors" enthält zwei Einträge. Jedes Bit im Bitmaparray stellt ein Pixel dar. Wenn das Bit klar ist, wird das Pixel mit der Farbe des ersten Eintrags in der bmiColors-Tabelle angezeigt; Wenn das Bit festgelegt ist, weist das Pixel die Farbe des zweiten Eintrags in der Tabelle auf.
2	Die Bitmap weist vier mögliche Farbwerte auf.
4	Die Bitmap verfügt über maximal 16 Farben, und das bmiColors-Element enthält bis zu 16 Einträge. Jedes Pixel in der Bitmap wird durch einen 4-Bit-Index in der Farbtabelle dargestellt. Wenn beispielsweise das erste Byte in der Bitmap 0x1F ist, stellt der Byte zwei Pixel dar. Das erste Pixel enthält die Farbe im zweiten Tabelleneintrag, und das zweite Pixel enthält die Farbe im Sechszehnten Tabelleneintrag.
8	Die Bitmap verfügt über maximal 256 Farben, und das bmiColors-Element enthält bis zu 256 Einträge. In diesem Fall stellt jedes Byte im Array ein einzelnes Pixel dar.
16	Die Bitmap hat maximal 2^16 Farben. Wenn das biCompression-Element des BITMAPINFOHEADER BI_RGB ist, ist das Element "bmiColors" NULL. Jedes WORD im Bitmaparray stellt ein einzelnes Pixel dar. Die relativen Intensitäten von Rot, Grün und Blau werden mit 5 Bit für jede Farbkomponente dargestellt. Der Wert für Blau liegt in den geringsten 5 Bits, gefolgt von 5 Bits für Grün und Rot. Das wichtigste Bit wird nicht verwendet. Die bmiColors-Farbtabelle wird zum Optimieren von Farben verwendet, die auf palettenbasierten Geräten verwendet werden, und muss die Anzahl der Einträge enthalten, die vom biClrUsed-Element angegeben werden.
24	Die Bitmap weist maximal 2^24 Farben auf, und das bmiColors-Element ist NULL. Jedes 3-Byte-Triplet im Bitmaparray stellt die relativen Intensitäten von Blau, Grün und Rot für ein Pixel dar. Die bmiColors-Farbtabelle wird zum Optimieren von Farben verwendet, die auf palettenbasierten Geräten verwendet werden, und muss die Anzahl der Einträge enthalten, die vom biClrUsed-Element angegeben werden.
32	Die Bitmap hat maximal 2^32 Farben. Wenn das biCompression-Element BI_RGB ist, ist das bmiColors-Element NULL. Jedes DWORD im Bitmaparray stellt die relativen Intensitäten von Blau, Grün und Rot für ein Pixel dar. Das hohe Byte in jedem DWORD wird nicht verwendet. Die bmiColors-Farbtabelle wird zum Optimieren von Farben verwendet, die auf palettenbasierten Geräten verwendet werden, und muss die Anzahl der Einträge enthalten, die vom biClrUsed-Element angegeben werden.

biCompression

Gibt den Komprimierungstyp für eine komprimierte bottom-up-Bitmap an (Top-down-DIBs können nicht komprimiert werden). Dieses Element kann eine der folgenden Werte sein.

Wert	BESCHREIBUNG
BI_RGB	Ein nicht komprimiertes Format.
BI_BITFIELDS	Gibt an, dass die Bitmap nicht komprimiert wird und dass die Farbtabelle aus drei DWORD-Farbmasken besteht, die die roten, grünen und blauen Komponenten bzw. die einzelnen Pixel angeben. Dies ist gültig, wenn sie mit 16-bpp- und 32-bpp-Bitmaps verwendet wird. Dieser Wert ist in Microsoft Windows CE Version 2.0 und höher gültig.

biSizeImage

Gibt die Größe des Bilds in Bytes an. Dies kann für BI_RGB Bitmaps auf Null festgelegt werden.

biXPelsPerMeter

Gibt die horizontale Auflösung in Pixel pro Meter des Zielgeräts für die Bitmap an. Eine Anwendung kann diesen Wert verwenden, um eine Bitmap aus einer Ressourcengruppe auszuwählen, die am besten mit den Merkmalen des aktuellen Geräts übereinstimmt.

biYPelsPerMeter

Gibt die vertikale Auflösung in Pixel pro Meter des Zielgeräts für die Bitmap an.

biClrUsed

Gibt die Anzahl der Farbindizes in der Farbtabelle an, die tatsächlich von der Bitmap verwendet werden. Wenn dieser Wert null ist, verwendet die Bitmap die maximale Anzahl von Farben, die dem Wert des biBitCount-Members für den durch biCompression angegebenen Komprimierungsmodus entsprechen.

biClrImportant

Gibt die Anzahl der Farbindizes an, die für die Anzeige der Bitmap erforderlich sind. Wenn dieser Wert null ist, sind alle Farben erforderlich.

Wenn biClrUsed nonzero ist und das biBitCount-Element kleiner als 16 ist, gibt das biClrUsed-Element die tatsächliche Anzahl der Farben an, auf die das Grafikmodul oder gerätetreiber zugreift. Wenn biBitCount 16 oder höher ist, gibt das biClrUsed-Element die Größe der Farbtabelle an, die zur Optimierung der Leistung der Systemfarbpaletten verwendet wird. Wenn biBitCount gleich 16 oder 32 ist, beginnt die optimale Farbpalette unmittelbar nach den drei DWORD-Masken.

Wenn die Bitmap eine gepackte Bitmap ist (eine Bitmap, in der das Bitmaparray unmittelbar der _BITMAPINFOHEADER Struktur folgt und von einem einzelnen Zeiger referenziert wird), muss das biClrUsed-Element entweder null oder die tatsächliche Größe der Farbtabelle sein.

Bemerkungen

Diese Struktur ist in einer _VIDEOINFOHEADER Struktur enthalten.

Requirements (Anforderungen)

Anforderung	Wert
Header	Wmdm.idl

Siehe auch

Strukturen

_VIDEOINFOHEADER