Funzione EngCreateDeviceSurface (winddi.h)

La funzione EngCreateDeviceSurface crea e restituisce un handle per una superficie del dispositivo che il driver gestirà.

Sintassi

ENGAPI HSURF EngCreateDeviceSurface(
  [in] DHSURF dhsurf,
  [in] SIZEL  sizl,
       ULONG  iFormatCompat
);

Parametri

[in] dhsurf

Handle del dispositivo nell'area da gestire dal dispositivo. Questo handle viene passato al driver quando viene passata una struttura SURFOBJ per l'input o l'output.

[in] sizl

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

iFormatCompat

Specifica il formato del motore compatibile dell'area del dispositivo creato. Questa operazione viene usata da GDI se è necessario un buffer temporaneo per simulare una chiamata di disegno complessa.

Valore restituito

Il valore restituito è un handle che identifica la superficie se la funzione ha esito positivo. In caso contrario, è zero e viene registrato un codice di errore.

Commenti

Lo spazio di archiviazione per la superficie può essere fornito facoltativamente dal driver. La superficie deve essere associata usando EngAssociateSurface. La superficie deve essere eliminata quando non è più necessaria usando EngDeleteSurface.

Requisiti

Vedi anche

EngAssociateSurface

EngDeleteSurface

SURFOBJ