Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
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) |