estructura DD_UPDATEOVERLAYDATA (ddrawint.h)
La estructura DD_UPDATEOVERLAYDATA contiene información necesaria para actualizar una superficie superpuesta.
Sintaxis
typedef struct _DD_UPDATEOVERLAYDATA {
PDD_DIRECTDRAW_GLOBAL lpDD;
PDD_SURFACE_LOCAL lpDDDestSurface;
RECTL rDest;
PDD_SURFACE_LOCAL lpDDSrcSurface;
RECTL rSrc;
DWORD dwFlags;
DDOVERLAYFX overlayFX;
HRESULT ddRVal;
VOID *UpdateOverlay;
} *PDD_UPDATEOVERLAYDATA, DD_UPDATEOVERLAYDATA;
Miembros
lpDD
Apunta a una estructura de DD_DIRECTDRAW_GLOBAL que describe el dispositivo del controlador.
lpDDDestSurface
Apunta a una estructura de DD_SURFACE_LOCAL que representa la superficie de Microsoft DirectDraw que se va a superponer. Este valor puede ser NULL si DDOVER_HIDE se especifica en dwFlags.
rDest
Especifica una estructura RECTL que contiene la x, y, width y height de la región en la superficie de destino que se va a superponer.
lpDDSrcSurface
Apunta a una estructura de DD_SURFACE_LOCAL que describe la superficie superpuesta.
rSrc
Especifica una estructura RECTL que contiene la x, y, width y height de la región en la superficie de origen que se va a usar para la superposición.
dwFlags
Especifica cómo debe controlar el controlador la superposición. Este miembro puede ser una combinación de cualquiera de las marcas siguientes:
| Marca | Significado |
|---|---|
| DDOVER_ADDDIRTYRECT | El controlador debe omitirlo. |
| DDOVER_AUTOFLIP | El controlador debe realizar automáticamente la superposición cada vez que el puerto de vídeo de hardware se abra automáticamente. Los controladores que admiten extensiones de puerto de vídeo (VPE) solo necesitan comprobar esta marca. |
| DDOVER_BOB | El controlador debe mostrar cada campo de los datos del objeto VPE individualmente sin causar artefactos jittery. Esta marca pertenece tanto a VPE como a descodificadores que quieren hacer su propio volteo en modo kernel mediante la funcionalidad de transporte de vídeo en modo kernel. |
| DDOVER_BOBHARDWARE | Indica que bob se realiza por hardware en lugar de por software o emulación. Los controladores que admiten VPE solo necesitan comprobar esta marca. |
| DDOVER_DDFX | El controlador debe mostrar la superficie de superposición mediante los atributos especificados por el miembro overlayFX . |
| DDOVER_HIDE | El controlador debe ocultar la superposición; es decir, el controlador debe desactivar esta superposición. |
| DDOVER_INTERLEAVED | La superficie superpuesta se compone de campos intercalados. Los controladores que admiten VPE solo necesitan comprobar esta marca. |
| DDOVER_KEYDEST | El controlador debe usar la clave de color asociada a la superficie de destino. |
| DDOVER_KEYDESTOVERRIDE | El controlador debe usar el miembro dckDestColorKey de la estructura DDOVERLAYFX (descrita en la documentación del SDK de DirectDraw) como clave de color de destino en lugar de la clave de color asociada a la superficie de destino. |
| DDOVER_KEYSRC | El controlador debe usar la clave de color asociada a la superficie de destino. |
| DDOVER_KEYSRCOVERRIDE | El controlador debe usar el miembro dckSrcColorKey de la estructura DDOVERLAYFX (descrita en la documentación del SDK de DirectDraw) como clave de color de origen en lugar de la clave de color asociada a la superficie de destino. |
| DDOVER_OVERRIDEBOBWEAVE | Otras interfaces no deben invalidar las decisiones de Bob/weave. Si el mezclador de superposición establece esta marca, DirectDraw no permite que un controlador en modo kernel use la funcionalidad de transporte de vídeo en modo kernel para cambiar el hardware entre bob y el modo de guardado. |
| DDOVER_REFRESHALL | El controlador debe omitirlo. |
| DDOVER_REFRESHDIRTYRECTS | El controlador debe omitirlo. |
| DDOVER_SHOW | El controlador debe mostrar la superposición; es decir, el controlador debe activar esta superposición. |
overlayFX
Especifica una estructura DDOVERLAYFX (descrita en la documentación del SDK de DirectDraw) que describe los efectos adicionales que el controlador debe usar para actualizar la superposición. El controlador solo debe usar esta estructura si se establece uno de DDOVER_DDFX, DDOVER_KEYDESTOVERRIDE o DDOVER_KEYSRCOVERRIDE en el miembro dwFlags .
ddRVal
Especifica la ubicación en la que el controlador escribe el valor devuelto de la devolución de llamada DdUpdateOverlay . 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.
UpdateOverlay
Lo usa la API de DirectDraw y el controlador no debe rellenarlo.
Requisitos
| Encabezado | ddrawint.h (incluya Winddi.h) |