Función EngCreateDeviceSurface (winddi.h)
La función EngCreateDeviceSurface crea y devuelve un identificador para una superficie de dispositivo que administrará el controlador.
Sintaxis
ENGAPI HSURF EngCreateDeviceSurface(
[in] DHSURF dhsurf,
[in] SIZEL sizl,
ULONG iFormatCompat
);
Parámetros
[in] dhsurf
Identificador de dispositivo a la superficie que va a administrar el dispositivo. Este identificador se pasa al controlador cuando se pasa una estructura SURFOBJ para la entrada o salida.
[in] sizl
Especifica una estructura SIZEL que contiene el ancho y alto de la superficie que se va a crear. Los miembros cx y cy de esta estructura contienen respectivamente el ancho y el alto de la superficie, en píxeles. Una estructura SIZEL es idéntica a una estructura SIZE .
iFormatCompat
Especifica el formato de motor compatible de la superficie del dispositivo que se va a crear. GDI lo usa si se necesita un búfer temporal para simular una llamada de dibujo complicada.
Valor devuelto
El valor devuelto es un identificador que identifica la superficie si la función se realiza correctamente. De lo contrario, es cero y se registra un código de error.
Comentarios
El controlador puede proporcionar opcionalmente el espacio de almacenamiento para la superficie. La superficie debe asociarse mediante EngAssociateSurface. La superficie debe eliminarse cuando ya no sea necesaria mediante EngDeleteSurface.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Disponible en Windows 2000 y versiones posteriores de los sistemas operativos Windows. |
| Plataforma de destino | Universal |
| Encabezado | winddi.h (incluya Winddi.h) |
| Library | Win32k.lib |
| Archivo DLL | Win32k.sys |