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

Vedi anche

Supporto client grafica di basso livello