Funzione DdCreateDIBSection (ddrawgdi.h)
[Questa funzione è soggetta a modifiche con ogni revisione del sistema operativo. Usare invece Microsoft DirectDraw e Microsoft Direct3DAPIs; queste API isolano le applicazioni da tali modifiche al sistema operativo e nascondono molte altre difficoltà nell'interagire direttamente con i driver di visualizzazione.
Crea una struttura DIBSECTION che condivide la tabella dei colori con il dispositivo.
GdiEntry9 è definito come alias per questa funzione.
Sintassi
HBITMAP DdCreateDIBSection(
HDC hdc,
const BITMAPINFO *pbmi,
UINT iUsage,
VOID **ppvBits,
HANDLE hSectionApp,
DWORD dwOffset
);
Parametri
hdc
Un controller di dominio valido compatibile con il dispositivo di visualizzazione corrente.
pbmi
Puntatore a una struttura BITMAPINFO che descrive la diBSECTION richiesta.
iUsage
Specifica il tipo di dati contenuti nel membro della matrice bmiColors della struttura BITMAPINFO a cui punta pbmi (indici della tavolozza logica o valori RGB letterali). Vengono definiti i valori seguenti.
(DIB_PAL_COLORS)
Il membro bmiColors è una matrice di indici a 16 bit nella tavolozza logica del contesto di dispositivo specificato da hdc.
(DIB_RGB_COLORS)
La struttura BITMAPINFO contiene una matrice di valori RGB letterali.
ppvBits
Puntatore a un puntatore ai dati DIBSECTION creati.
hSectionApp
Riservato. Deve essere NULL.
dwOffset
Valore restituito
In caso di esito positivo, questa funzione restituisce un handle a una bitmap che rappresenta DIBSECTION; in caso contrario restituisce NULL.
Commenti
La chiamata a questa funzione garantisce una tavolozza delle identità e nessuna conversione della tavolozza quando vengono chiamati IDirectDrawSurface7::Blt o StretchBlt .
Le applicazioni sono consigliate di usare IDirectDrawSurface7, che può creare superfici a 8 bit per pixel, con tavolozza delle identità in modo indipendente dal sistema operativo.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 2000 Professional [solo app desktop] |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | ddrawgdi.h |