Función EngCreateDeviceSurface (winddi.h)

  • Artículo

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

Consulte también

EngAssociateSurface

EngDeleteSurface

SURFOBJ