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)

Consulte también

DdUpdateOverlay