DdCreateDIBSection-Funktion (ddrawgdi.h)
[Diese Funktion kann sich mit jeder Betriebssystemrevision ändern. Verwenden Sie stattdessen die Microsoft DirectDraw- und Microsoft Direct3DAPIs. diese APIs isolieren Anwendungen vor solchen Betriebssystemänderungen und verbergen viele andere Schwierigkeiten, die bei der direkten Interaktion mit Anzeigetreibern auftreten.]
Erstellt eine DIBSECTION-Struktur , die ihre Farbtabelle mit dem Gerät teilt.
GdiEntry9 ist als Alias für diese Funktion definiert.
Syntax
HBITMAP DdCreateDIBSection(
HDC hdc,
const BITMAPINFO *pbmi,
UINT iUsage,
VOID **ppvBits,
HANDLE hSectionApp,
DWORD dwOffset
);
Parameter
hdc
Ein gültiger DC-Wert, der mit dem aktuellen Anzeigegerät kompatibel ist.
pbmi
Zeiger auf eine BITMAPINFO-Struktur , die die angeforderte DIBSECTION beschreibt.
iUsage
Gibt den Typ der Daten an, die im bmiColors-Arraymember der BITMAPINFO-Struktur enthalten sind, auf die von pbmi verwiesen wird (entweder logische Palettenindizes oder literale RGB-Werte). Die folgenden Werte werden definiert.
(DIB_PAL_COLORS)
Das bmiColors-Element ist ein Array von 16-Bit-Indizes in der logischen Palette des von hdc angegebenen Gerätekontexts.
(DIB_RGB_COLORS)
Die BITMAPINFO-Struktur enthält ein Array von RGB-Literalwerten.
ppvBits
Zeiger auf einen Zeiger auf die erstellten DIBSECTION-Daten .
hSectionApp
Reserviert. Muss NULL sein.
dwOffset
Rückgabewert
Bei erfolgreicher Ausführung gibt diese Funktion ein Handle an eine Bitmap zurück, die die DIBSECTION darstellt. Andernfalls wird NULL zurückgegeben.
Hinweise
Das Aufrufen dieser Funktion stellt eine Identitätspalette und keine Palettenkonvertierung sicher, wenn IDirectDrawSurface7::Blt oder StretchBlt aufgerufen werden.
Anwendungen wird empfohlen, IDirectDrawSurface7 zu verwenden, das 8-Bit-pro-Pixel-, Identitätspalettenoberflächen unabhängig vom Betriebssystem erstellen kann.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | ddrawgdi.h |