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) |