estrutura DD_UPDATEOVERLAYDATA (ddrawint.h)

A estrutura DD_UPDATEOVERLAYDATA contém informações necessárias para atualizar uma superfície de sobreposição.

Sintaxe

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;

Membros

lpDD

Aponta para uma estrutura DD_DIRECTDRAW_GLOBAL que descreve o dispositivo do driver.

lpDDDestSurface

Aponta para uma estrutura DD_SURFACE_LOCAL que representa a superfície do Microsoft DirectDraw a ser sobreposta. Esse valor poderá ser NULL se DDOVER_HIDE for especificado em dwFlags.

rDest

Especifica uma estrutura RECTL que contém x, y, largura e altura da região na superfície de destino a ser sobreposta.

lpDDSrcSurface

Aponta para uma estrutura DD_SURFACE_LOCAL que descreve a superfície de sobreposição.

rSrc

Especifica uma estrutura RECTL que contém x, y, largura e altura da região na superfície de origem a ser usada para a sobreposição.

dwFlags

Especifica como o driver deve lidar com a sobreposição. Esse membro pode ser uma combinação de qualquer um dos seguintes sinalizadores:

Sinalizador	Significado
DDOVER_ADDDIRTYRECT	Deve ser ignorado pelo driver.
DDOVER_AUTOFLIP	O driver deve passar automaticamente a sobreposição sempre que a porta de vídeo de hardware passar automaticamente. Os drivers que dão suporte a VPE (extensões de porta de vídeo) só precisam marcar esse sinalizador.
DDOVER_BOB	O driver deve exibir cada campo de dados de objeto VPE individualmente sem causar artefatos nervosos. Esse sinalizador pertence a VPE e decodificadores que desejam fazer sua própria inversão no modo kernel usando a funcionalidade de transporte de vídeo no modo kernel.
DDOVER_BOBHARDWARE	Indica que bob é executado por hardware e não por software ou emulação. Os drivers que dão suporte à VPE só precisam marcar esse sinalizador.
DDOVER_DDFX	O driver deve mostrar a superfície de sobreposição usando os atributos especificados pelo membro overlayFX .
DDOVER_HIDE	O driver deve ocultar a sobreposição; ou seja, o driver deve desativar essa sobreposição.
DDOVER_INTERLEAVED	A superfície de sobreposição é composta de campos intercalados. Os drivers que dão suporte à VPE só precisam marcar esse sinalizador.
DDOVER_KEYDEST	O driver deve usar a chave de cor associada à superfície de destino.
DDOVER_KEYDESTOVERRIDE	O driver deve usar o membro dckDestColorKey da estrutura DDOVERLAYFX (descrita na documentação do SDK do DirectDraw) como a chave de cor de destino em vez da chave de cor associada à superfície de destino.
DDOVER_KEYSRC	O driver deve usar a chave de cor associada à superfície de destino.
DDOVER_KEYSRCOVERRIDE	O driver deve usar o membro dckSrcColorKey da estrutura DDOVERLAYFX (descrita na documentação do SDK do DirectDraw) como a chave de cor de origem em vez da chave de cor associada à superfície de destino.
DDOVER_OVERRIDEBOBWEAVE	As decisões bob/weave não devem ser substituídas por outras interfaces. Se o mixer de sobreposição definir esse sinalizador, o DirectDraw não permitirá que um driver de modo kernel use a funcionalidade de transporte de vídeo no modo kernel para alternar o hardware entre o modo bob e weave.
DDOVER_REFRESHALL	Deve ser ignorado pelo driver.
DDOVER_REFRESHDIRTYRECTS	Deve ser ignorado pelo driver.
DDOVER_SHOW	O driver deve mostrar a sobreposição; ou seja, o driver deve ativar essa sobreposição.

overlayFX

Especifica uma estrutura DDOVERLAYFX (descrita na documentação do SDK do DirectDraw) que descreve efeitos adicionais que o driver deve usar para atualizar a sobreposição. O driver deverá usar essa estrutura somente se um dos DDOVER_DDFX, DDOVER_KEYDESTOVERRIDE ou DDOVER_KEYSRCOVERRIDE estiver definido no membro dwFlags .

ddRVal

Especifica o local em que o driver grava o valor retornado do retorno de chamada DdUpdateOverlay . Um código de retorno de DD_OK indica êxito. Para obter mais informações, consulte Valores retornados para DirectDraw.

UpdateOverlay

Usado pela API do DirectDraw e não deve ser preenchido pelo driver.

Requisitos

Cabeçalho	ddrawint.h (inclua Winddi.h)

Confira também

DdUpdateOverlay