_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 von Bytes an, die für die -Struktur erforderlich sind.

biWidth

Gibt die Breite der Bitmap in Pixel an.

biHeight

Gibt die Höhe der Bitmap in Pixel an. Wenn biHeight positiv ist, ist die Bitmap ein DIB von unten nach oben, und ihr Ursprung ist die untere linke Ecke. Wenn biHeight negativ ist, ist die Bitmap ein DIB von oben nach unten, und ihr Ursprung ist die obere linke Ecke. Wenn biHeight negativ ist und einen Top-Down-DIB angibt, 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 definieren, und die maximale Anzahl von Farben in der Bitmap. Dieser Member muss einer der folgenden Werte sein.

Wert	BESCHREIBUNG
1	Die Bitmap ist monochrom, und das bmiColors-Element 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 Tabelle bmiColors angezeigt. wenn das Bit festgelegt ist, hat das Pixel die Farbe des zweiten Eintrags in der Tabelle.
2	Die Bitmap weist vier mögliche Farbwerte auf.
4	Die Bitmap hat 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 das Byte zwei Pixel dar. Das erste Pixel enthält die Farbe im zweiten Tabelleneintrag, und das zweite Pixel enthält die Farbe im sechzehnten Tabelleneintrag.
8	Die Bitmap hat 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 weist maximal 2^16 Farben auf. Wenn das biCompression-Element von BITMAPINFOHEADER BI_RGB ist, ist das bmiColors-Element NULL. Jedes WORD im Bitmaparray stellt ein einzelnes Pixel dar. Die relativen Intensitäten von Rot, Grün und Blau werden mit 5 Bits für jede Farbkomponente dargestellt. Der Wert für Blau ist in den am wenigsten signifikanten 5 Bits, gefolgt von jeweils 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 von Einträgen enthalten, die vom biClrUsed-Element angegeben werden.
24	Die Bitmap hat maximal 2^24 Farben, und das bmiColors-Element ist NULL. Jedes 3-Byte-Triplet im Bitmaparray stellt die relativen Intensitäten von Blau, Grün bzw. 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 von Einträgen 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 bzw. 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 von Einträgen 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). Dieser Member kann einer der folgenden Werte sein.

Wert	BESCHREIBUNG
BI_RGB	Ein unkomprimiertes 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 jedes Pixels angeben. Dies ist bei Verwendung mit 16-bpp- und 32-bpp-Bitmaps gültig. 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 0 festgelegt werden.

biXPelsPerMeter

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

biYPelsPerMeter

Gibt die vertikale Auflösung des Zielgeräts für die Bitmap in Pixel pro Meter 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-Elements für den von biCompression angegebenen Komprimierungsmodus entsprechen.

biClrImportant

Gibt die Anzahl der Farbindizes an, die zum Anzeigen der Bitmap erforderlich sind. Wenn dieser Wert null ist, sind alle Farben erforderlich.

Wenn biClrUsed ungleich 0 ist und das biBitCount-Element kleiner als 16 ist, gibt das biClrUsed-Element die tatsächliche Anzahl von Farben an, auf die die Grafik-Engine oder der Gerätetreiber zugreift. Wenn biBitCount 16 oder höher ist, gibt das biClrUsed-Element die Größe der Farbtabelle an, die zum Optimieren der Leistung der Systemfarbpaletten verwendet wird. Wenn biBitCount gleich 16 oder 32 ist, beginnt die optimale Farbpalette unmittelbar nach den drei DWORD-Masken.

Wenn es sich bei der Bitmap um eine gepackte Bitmap handelt (eine Bitmap, bei der das Bitmaparray unmittelbar der _BITMAPINFOHEADER-Struktur folgt und auf die mit einem einzelnen Zeiger verwiesen wird), muss das biClrUsed-Element entweder null oder die tatsächliche Größe der Farbtabelle aufweisen.

Bemerkungen

Diese Struktur ist in einer _VIDEOINFOHEADER-Struktur enthalten.

Anforderungen

Anforderung	Wert
Header	Wmdm.idl

Siehe auch

Strukturen

_VIDEOINFOHEADER