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

Vedi anche

DrvDeleteDeviceBitmap