Función DrvDeriveSurface (winddi.h)
La función DrvDeriveSurface deriva una superficie GDI de la superficie de DirectDraw especificada.
Sintaxis
HBITMAP DrvDeriveSurface(
DD_DIRECTDRAW_GLOBAL *pDirectDraw,
DD_SURFACE_LOCAL *pSurface
);
Parámetros
pDirectDraw
Puntero a una estructura de DD_DIRECTDRAW_GLOBAL que describe el objeto DirectDraw.
pSurface
Puntero a una estructura de DD_SURFACE_LOCAL que describe la superficie de DirectDraw alrededor de la que se va a encapsular una superficie GDI.
Valor devuelto
DrvDeriveSurface devuelve un identificador a la superficie GDI derivada tras el éxito. Devuelve NULL si se produce un error en la llamada o si el controlador no puede acelerar el dibujo GDI a la superficie de DirectDraw especificada.
Comentarios
DrvDeriveSurface permite al controlador crear una superficie GDI ajustada alrededor de una memoria de vídeo de DirectDraw o un objeto de superficie AGP para permitir el dibujo de GDI acelerado a la superficie. Si el controlador no enlaza esta llamada, todo el dibujo de GDI en las superficies de DirectDraw se realiza en software mediante el motor DIB.
GDI llama a DrvDeriveSurface solo con superficies RGB.
El controlador debe llamar a DrvCreateDeviceBitmap para crear una superficie GDI con el mismo tamaño y formato que el de la superficie de DirectDraw. No es necesario asignar espacio para los píxeles reales, ya que ya existe.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Escritorio |
| Encabezado | winddi.h (incluya Winddi.h) |