estructura DD_BLTDATA (ddrawint.h)
La estructura de DD_BLTDATA contiene la información relevante para el controlador para realizar transferencias de bloques de bits.
Sintaxis
typedef struct _DD_BLTDATA {
PDD_DIRECTDRAW_GLOBAL lpDD;
PDD_SURFACE_LOCAL lpDDDestSurface;
RECTL rDest;
PDD_SURFACE_LOCAL lpDDSrcSurface;
RECTL rSrc;
DWORD dwFlags;
DWORD dwROPFlags;
DDBLTFX bltFX;
HRESULT ddRVal;
VOID *Blt;
BOOL IsClipped;
RECTL rOrigDest;
RECTL rOrigSrc;
DWORD dwRectCnt;
LPRECT prDestRects;
DWORD dwAFlags;
DDARGB ddargbScaleFactors;
} *PDD_BLTDATA, DD_BLTDATA;
Miembros
lpDD
Apunta a una estructura de DD_DIRECTDRAW_GLOBAL que describe el dispositivo del controlador.
lpDDDestSurface
Apunta a la estructura DD_SURFACE_LOCAL que describe la superficie en la que se va a dividir.
rDest
lpDDSrcSurface
Apunta a una estructura de DD_SURFACE_LOCAL que describe la superficie de origen.
rSrc
dwFlags
Indica un conjunto de marcas que especifican el tipo de operación blit que se va a realizar y qué miembros de estructura asociados tienen datos válidos que debe usar el controlador. Este miembro es un OR bit a bit de cualquiera de las marcas siguientes:
| Marca | Significado |
|---|---|
| DDBLT_ASYNC | Realice esta operación de forma asincrónica a través del FIFO en el orden recibido. Si no existe espacio en el FIFO de hardware, el controlador debe producir un error en la llamada y volver inmediatamente. |
| DDBLT_COLORFILL | Use el miembro dwFillColor en la estructura DDBLTFX (definida en la documentación del SDK de Microsoft DirectDraw) como color RGB con el que rellenar el rectángulo de destino en la superficie de destino. |
| DDBLT_DDFX | Use el miembro dwDDFX en la estructura DDBLTFX (definida en la documentación del SDK de DirectDraw) para determinar los efectos que se usarán para la blit. |
| DDBLT_DDROPS | Esta marca está reservada para uso del sistema y el controlador debe omitirla. El controlador también debe omitir el miembro dwDDROPS de la estructura DDBLTFX. |
| DDBLT_EXTENDED_FLAGS |
|
| DDBLT_EXTENDED_LINEAR_CONTENT |
|
| DDBLT_EXTENDED_PRESENTATION_STRETCHFACTOR |
|
| DDBLT_KEYDESTOVERRIDE | Use el miembro dckDestColorkey en la estructura DDBLTFX (definida en la documentación del SDK de DirectDraw) como clave de color para la superficie de destino. Si no se establece una invalidación, dckDestColorkey no contiene la clave de color. El controlador debe probar la superficie en sí. |
| DDBLT_KEYSRCOVERRIDE | Use el miembro dckSrcColorkey en la estructura DDBLTFX (definida en la documentación del SDK de DirectDraw) como clave de color para la superficie de origen. Si no se establece una invalidación, dckDestColorkey no contiene la clave de color. El controlador debe probar la superficie en sí. |
| DDBLT_LAST_PRESENTATION |
|
| DDBLT_PRESENTATION |
|
| DDBLT_ROP | Use el miembro dwROP en la estructura DDBLTFX (definida en la documentación del SDK de DirectDraw) para la operación de trama de esta blit. Actualmente, el único ROP pasado al controlador es SRCCOPY. Este ROP es el mismo que el definido en la API de Win32. Consulte la documentación de Microsoft Windows SDK para obtener más información. |
| DDBLT_ROTATIONANGLE | Esta marca no se admite en Windows 2000 y versiones posteriores y el controlador debe omitirla. |
| DDBLT_WAIT | No vuelva inmediatamente con el mensaje de DDERR_WASSTILLDRAWING si el blitter está ocupado, espere hasta que se pueda configurar la blit u se produzca otro error. |
dwROPFlags
El controlador debe omitir un uso en Windows 2000 y versiones posteriores.
bltFX
#########
#######
ddRVal
Especifica la ubicación en la que el controlador escribe el valor devuelto de la devolución de llamada DdBlt . Un código de retorno de DD_OK indica que se ha realizado correctamente. Para obtener más información, vea Valores devueltos para DirectDraw.
Blt
Lo usa la API de DirectDraw y el controlador no debe rellenarlo.
IsClipped
Indica si se trata de una barra recortada. En Windows 2000 y versiones posteriores, este miembro siempre es FALSE, lo que indica que la barra de bits está desactivada.
rOrigDest
Sin usar para Windows 2000 y versiones posteriores. Especifica una estructura RECTL que define el rectángulo de destino no recortado. Este miembro solo es válido si IsClipped es TRUE.
rOrigSrc
Sin usar para Windows 2000 y versiones posteriores. Especifica una estructura RECTL que define el rectángulo de origen no recortado. Este miembro solo es válido si IsClipped es TRUE.
dwRectCnt
Sin usar para Windows 2000 y versiones posteriores.Especifica el número de rectángulos de destino a los que apunta prDestRects . Este miembro solo es válido si IsClipped es TRUE.
prDestRects
Sin usar para Windows 2000 y versiones posteriores. Apunta a una matriz de estructuras RECTL que describen los rectángulos de destino. Este miembro solo es válido si IsClipped es TRUE.
dwAFlags
El controlador debe omitir y no se debe usar.
ddargbScaleFactors
Factores de escalado arGB (AlphaBlt)
Comentarios
Para obtener más información sobre las marcas de DDBLT_PRESENTATION y DDBLT_LAST_PRESENTATION, vea Presentación.
Requisitos
| Requisito | Valor |
|---|---|
| Header | ddrawint.h (incluya Winddi.h) |