DIBSECTION-Struktur (wingdi.h)

Artikel
03/04/2024

Die DIBSECTION-Struktur enthält Informationen zu einer DIB, die durch Aufrufen der CreateDIBSection-Funktion erstellt wird. Eine DIBSECTION-Struktur enthält Informationen über die Abmessungen, das Farbformat, die Farbmasken, das optionale Dateizuordnungsobjekt und den optionalen Speicheroffset der Bitwerte. Eine Anwendung kann eine ausgefüllte DIBSECTION-Struktur für einen bestimmten DIB abrufen, indem sie die GetObject-Funktion aufruft .

Syntax

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

Member

dsBm

Eine BITMAP-Datenstruktur , die Informationen zum DIB enthält: seinen Typ, seine Abmessungen, seine Farbkapazitäten und einen Zeiger auf seine Bitwerte.

dsBmih

Eine BITMAPINFOHEADER-Struktur , die Informationen zum Farbformat des DIB enthält.

dsBitfields[3]

Gibt drei Farbmasken für die DIB an. Dieses Feld ist nur gültig, wenn das BitCount-Element der BITMAPINFOHEADER-Struktur einen Wert größer als 8 hat. Jede Farbmaske gibt die Bits an, die zum Codieren eines der drei Farbkanäle (Rot, Grün und Blau) verwendet werden.

dshSection

Enthält ein Handle für das Dateizuordnungsobjekt, das von der CreateDIBSection-Funktion zum Erstellen des DIB verwendet wurde. Wenn CreateDIBSection mit einem NULL-Wert für den hSection-Parameter aufgerufen wurde, was dazu führt, dass das System Arbeitsspeicher für die Bitmap zuordnet, ist der dshSection-MemberNULL.

dsOffset

Der Offset zu den Bitwerten der Bitmap innerhalb des Dateizuordnungsobjekts, auf das von dshSection verwiesen wird. Wenn dshSectionNULL ist, hat der dsOffset-Wert keine Bedeutung.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Kopfzeile	wingdi.h (windows.h einschließen)