PDD_SURFCB_UPDATEOVERLAY función de devolución de llamada (ddrawint.h)

Artículo
08/23/2023

La función de devolución de llamada DdUpdateOverlay cambia la posición o modifica los atributos visuales de una superficie superpuesta.

Sintaxis

PDD_SURFCB_UPDATEOVERLAY PddSurfcbUpdateoverlay;

DWORD PddSurfcbUpdateoverlay(
  PDD_UPDATEOVERLAYDATA unnamedParam1
)
{...}

Parámetros

unnamedParam1

Apunta a una estructura DD_UPDATEOVERLAYDATA que contiene la información necesaria para actualizar la superposición.

Valor devuelto

DdUpdateOverlay devuelve uno de los siguientes códigos de devolución de llamada:

Comentarios

DdUpdateOverlay muestra, oculta o cambia la posición de una superficie de superposición en la pantalla. También establece atributos de la superficie de superposición, como el factor extendido o el tipo de clave de color que se va a usar.

El controlador debe determinar si tiene el ancho de banda para admitir la solicitud de actualización de superposición. El controlador debe usar el miembro dwFlags de la estructura de DD_UPDATEOVERLAYDATA en lpUpdateOverlay para determinar el tipo de solicitud y cómo procesarlo.

El controlador o hardware debe estirar o reducir la superposición en consecuencia cuando los rectángulos especificados por los miembros rDest y rSrc de DD_UPDATEOVERLAYDATA son diferentes tamaños.

Tenga en cuenta que DdFlip se usa para voltear entre superficies superpuestas, por lo que el rendimiento de DdUpdateOverlay no es crítico.