Función EngModifySurface (winddi.h)
La función EngModifySurface notifica a GDI los atributos de una superficie creada por el controlador.
Sintaxis
ENGAPI BOOL EngModifySurface(
HSURF hsurf,
HDEV hdev,
FLONG flHooks,
FLONG flSurface,
DHSURF dhsurf,
VOID *pvScan0,
LONG lDelta,
VOID *pvReserved
);
Parámetros
hsurf
Identificador de la superficie que se va a modificar. Este parámetro es el identificador de superficie devuelto por EngCreateDeviceBitmap o EngCreateDeviceSurface, o desde el miembro hsurf de la estructura SURFOBJ .
hdev
Controla el dispositivo con el que se va a asociar la superficie. Este es el identificador que GDI pasó a DrvCompletePDEV.
flHooks
Es un conjunto de marcas que controlan las funciones que el controlador puede enlazar siempre que se produzca un dibujo GDI en la superficie especificada. Puede ser un OR bit a bit de cualquiera de los valores de HOOK_Xxx enumerados en la página de referencia de EngAssociateSurface .
flSurface
Es un conjunto de marcas que describen los atributos de la superficie. Actualmente, el controlador debe establecer esto en MS_NOTSYSTEMMEMORY cuando la superficie se encuentra en la memoria de vídeo.
dhsurf
Identifica la superficie del controlador. El controlador puede establecer esto en cualquier cosa; GDI establece el miembro dhsurf de la estructura SURFOBJ de la superficie resultante en este valor si la función es correcta.
pvScan0
Puntero a la dirección virtual del inicio del mapa de bits.
lDelta
Es el intervalo de direcciones virtuales del mapa de bits; es decir, el número de bytes entre el principio de una fila de mapa de bits y la siguiente.
pvReserved
Está reservado y siempre debe establecerse en NULL.
Valor devuelto
EngModifySurface devuelve TRUE tras el éxito; de lo contrario, devuelve FALSE.
Comentarios
EngModifySurface permite al controlador modificar una superficie administrada por el dispositivo e informar a GDI de los atributos de esta superficie. Esto permite a los conductores convertir la superficie de destino de ser opaco a noopaque, lo que permite que GDI se dibuje en la superficie.
El motor DIB usa pvScan0 y lDelta para dibujar directamente a la superficie. Cuando estos parámetros son NULL, la superficie es opaca a GDI y GDI revertirá a llamar a DrvCopyBits para las operaciones de dibujo no enlazadas por el controlador.
Después de que DrvEnableSurface devuelva un identificador a una superficie principal, no llame a EngModifySurface en ese identificador. Si lo hace, puede provocar una comprobación de errores en determinadas circunstancias. Para obtener más información, consulte el artículo de Microsoft Knowledge Base 330248.
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 |