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
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile in Windows 2000 e versioni successive dei sistemi operativi Windows. |
| Piattaforma di destinazione | Universale |
| Intestazione | winddi.h (include Winddi.h) |
| Libreria | Win32k.lib |
| DLL | Win32k.sys |