Funzione DrvCreateDeviceBitmap (winddi.h)

La funzione DrvCreateDeviceBitmap crea e gestisce le bitmap.

Sintassi

HBITMAP DrvCreateDeviceBitmap(
  DHPDEV dhpdev,
  SIZEL  sizl,
  ULONG  iFormat
);

Parametri

dhpdev

Handle al PDEV che descrive il dispositivo fisico designato da un'applicazione come destinazione primaria per una bitmap. Il formato della bitmap deve essere compatibile con questo dispositivo fisico.

sizl

Specifica una struttura SIZEL che contiene la larghezza e l'altezza della bitmap da creare. I membri cx e cy di questa struttura contengono rispettivamente la larghezza e l'altezza della bitmap, in pixel. Una struttura SIZEL è identica a una struttura SIZE.

iFormat

Specifica il formato bitmap, che indica il numero richiesto di informazioni sul colore per pixel e corrisponde sempre al formato del primario. I valori validi sono i seguenti:

Valore	Significato
BMF_8BPP	8 bit per pixel.
BMF_16BPP	16 bit per pixel.
BMF_24BPP	24 bit per pixel.
BMF_32BPP	32 bit per pixel.

Valore restituito

Il valore restituito è un handle che identifica la bitmap creata se la funzione ha esito positivo. Se il driver sceglie di creare e gestire la bitmap, il valore restituito è zero. Se si verifica un errore, il valore restituito è 0xFFFFFFFF e GDI registra un codice di errore.

Commenti

Se il driver crea la bitmap, può archiviarla ovunque e in qualsiasi formato. Si presuppone che il driver tenga conto delle specifiche dei parametri e fornisca una bitmap con almeno il numero di bit per pixel richiesto.

Il contenuto della bitmap creata non è definito.

Questa funzione è facoltativa. Se questa funzione viene implementata, tuttavia, è necessario implementare drvDeleteDeviceBitmap .

Requisiti

Piattaforma di destinazione	Desktop
Intestazione	winddi.h (include Winddi.h)

Vedi anche

DrvDeleteDeviceBitmap