PDD_SURFCB_UPDATEOVERLAY função de retorno de chamada (ddrawint.h)

Artigo
08/23/2023

A função de retorno de chamada DdUpdateOverlay reposiciona ou modifica os atributos visuais de uma superfície de sobreposição.

Sintaxe

PDD_SURFCB_UPDATEOVERLAY PddSurfcbUpdateoverlay;

DWORD PddSurfcbUpdateoverlay(
  PDD_UPDATEOVERLAYDATA unnamedParam1
)
{...}

Parâmetros

unnamedParam1

Aponta para uma estrutura DD_UPDATEOVERLAYDATA que contém as informações necessárias para atualizar a sobreposição.

Valor retornado

DdUpdateOverlay retorna um dos seguintes códigos de retorno de chamada:

Comentários

DdUpdateOverlay mostra, oculta ou reposiciona uma superfície de sobreposição na tela. Ele também define atributos da superfície de sobreposição, como o fator elástico ou o tipo de chave de cor a ser usada.

O driver deve determinar se ele tem a largura de banda para dar suporte à solicitação de atualização de sobreposição. O driver deve usar o membro dwFlags da estrutura DD_UPDATEOVERLAYDATA em lpUpdateOverlay para determinar o tipo de solicitação e como processá-la.

O driver/hardware deve esticar ou reduzir a sobreposição adequadamente quando os retângulos especificados pelos membros rDest e rSrc de DD_UPDATEOVERLAYDATA são tamanhos diferentes.

Observe que ddFlip é usado para inverter entre superfícies de sobreposição, portanto, o desempenho de DdUpdateOverlay não é crítico.