IDirectDrawSurface::UpdateOverlay

9/8/2008

Este método reposiciona ou modifica os atributos visuais de uma superfície sobreposição. Esses superfícies devem ter o sinalizador DDSCAPS_OVERLAY definido.

Syntax

HRESULT UpdateOverlay(
  LPRECT lpSrcRect, 
  LPDIRECTDRAWSURFACE lpDDDestSurface, 
  LPRECT lpDestRect, 
  DWORD dwFlags, 
  LPDDOVERLAYFX lpDDOverlayFx
); 

Parameters

• lpSrcRect
  Endereço de um RECT estrutura que define o x, y, largura e altura da região na superfície origem sendo usada como a sobreposição.

  Este parâmetro pode ser NULL quando ocultando uma sobreposição, ou para indicar que a superfície sobreposição inteira é para ser usado e que a superfície sobreposição está de acordo com quaisquer restrições alinhamento limite e tamanho impostas pela driver de dispositivo.

• lpDDDestSurface
  Endereço das IDirectDrawSurface interface para a superfície que está sendo sobreposta.

• lpDestRect
  Endereço de um RECT estrutura que define o x, y, largura e altura da região na superfície do destino que a sobreposição deve ser moveu para. Este parâmetro pode ser NULL quando ocultando a sobreposição.

• dwFlags
  A seguinte tabela mostra os sinalizadores possíveis.

  Sinalizador	Descrição
  DDOVER_ALPHACONSTOVERRIDE	Indica que a sobreposição deve ser alfa-outras com o destino usando o membro dwAlphaConst das DDOVERLAYFX estrutura.
  DDOVER_ALPHADEST	Usa qualquer de alfa informações em formato pixel ou de alfa canalizar anexado superfície para a superfície destino como a alfa canalizar para essa sobreposição.
  DDOVER_ALPHADESTNEG	Indica que a superfície destino se torna mais transparente como a alfa aumenta valor (zero opacidade de igual).
  DDOVER_ALPHASRC	Usa qualquer de alfa informações em formato pixel ou de alfa canalizar anexado superfície para a superfície origem como a alfa origem canalizar para essa sobreposição.
  DDOVER_ALPHASRCNEG	Indica que a superfície origem se torna mais transparente como a alfa aumenta valor (é zero opacidade).
  DDOVER_HIDE	Desativa essa sobreposição.
  DDOVER_KEYDEST	Usa a chave cor associado com a superfície destino.
  DDOVER_KEYDESTOVERRIDE	Usa o dckDestColorkey membro das DDOVERLAYFX estrutura como a chave cor de superfície de destino.
  DDOVER_KEYSRC	Usa a chave cor associado com a superfície origem.
  DDOVER_KEYSRCOVERRIDE	Usa o dckSrcColorkey membro das DDOVERLAYFX estrutura como a chave cor de superfície de origem.
  DDOVER_MIRRORLEFTRIGHT	Processa a sobreposição como espelhados para que do lado esquerdo da superfície é desenhado no direito e o direito lado é desenhado em à esquerda.
  DDOVER_MIRRORUPDOWN	Processa a sobreposição como espelhados para que o parte superior da superfície é desenhado na inferior e a inferior é desenhado na parte superior.
  DDOVER_SHOW	Ative essa sobreposição.
  DDOVER_WAITNOTBUSY	Espera por uma operação de desenho anteriormente iniciada para completo instead of retornar imediatamente com a DDERR_WASSTILLDRAWING valor de retorno. Se uma operação de desenho anterior for em andamento no tempo do chamar, este sinalizador adia retornando do chamar até que a sobreposição é atualizada ou ocorrerá um erro.
  DDOVER_WAITVSYNC	Aguarda um V-sincronização antes de executar a atualização sobreposição.

• lpDDOverlayFx
  Endereço de um DDOVERLAYFX estrutura que descreve os efeitos para ser usado. Este parâmetro pode ser NULL se o sinalizador DDOVER_DDFX não for especificado.

Return Value

Se o método for bem-sucedido, o valor de retorno é DD_OK.

Se o método falhar, o valor de retorno pode ser uma do seguinte valores de erro:

DDERR_DEVICEDOESNTOWNSURFACE

DDERR_GENERIC

DDERR_HEIGHTALIGN

DDERR_INVALIDOBJECT

DDERR_INVALIDPARAMS

DDERR_INVALIDRECT

DDERR_NOSTRETCHHW

DDERR_NOTAOVERLAYSURFACE

DDERR_OUTOFCAPS

DDERR_SURFACELOST

DDERR_UNSUPPORTED

Para obter mais informações sobre esses erros códigos Consulte DirectDraw Return Values.

Requirements

Header	ddraw.h
Library	ddraw.lib
Windows Embedded CE	Windows Embedded CE 6.0 and later
Windows Mobile	Pocket PC for Windows Mobile Version 5.0 and later, Smartphone for Windows Mobile Version 5.0 and later