estrutura DDCAPS_DX3 (ddraw.h)

A estrutura DDCAPS representa os recursos do hardware exposto por meio do objeto DirectDraw. Essa estrutura contém uma estrutura DDSCAPS2 usada neste contexto para descrever quais tipos de objetos DirectDrawSurface podem ser criados. Talvez não seja possível criar todas as superfícies descritas por esses recursos simultaneamente. Essa estrutura é usada com o método IDirectDraw7::GetCaps .

O arquivo de cabeçalho Ddraw.h contém várias versões dessa estrutura (por exemplo, DDCAPS_DX7). Para obter mais informações sobre como determinar qual versão usar, consulte Comentários.

Sintaxe

typedef struct _DDCAPS_DX3 {
  DWORD   dwSize;
  DWORD   dwCaps;
  DWORD   dwCaps2;
  DWORD   dwCKeyCaps;
  DWORD   dwFXCaps;
  DWORD   dwFXAlphaCaps;
  DWORD   dwPalCaps;
  DWORD   dwSVCaps;
  DWORD   dwAlphaBltConstBitDepths;
  DWORD   dwAlphaBltPixelBitDepths;
  DWORD   dwAlphaBltSurfaceBitDepths;
  DWORD   dwAlphaOverlayConstBitDepths;
  DWORD   dwAlphaOverlayPixelBitDepths;
  DWORD   dwAlphaOverlaySurfaceBitDepths;
  DWORD   dwZBufferBitDepths;
  DWORD   dwVidMemTotal;
  DWORD   dwVidMemFree;
  DWORD   dwMaxVisibleOverlays;
  DWORD   dwCurrVisibleOverlays;
  DWORD   dwNumFourCCCodes;
  DWORD   dwAlignBoundarySrc;
  DWORD   dwAlignSizeSrc;
  DWORD   dwAlignBoundaryDest;
  DWORD   dwAlignSizeDest;
  DWORD   dwAlignStrideAlign;
  DWORD   dwRops[DD_ROP_SPACE];
  DDSCAPS ddsCaps;
  DWORD   dwMinOverlayStretch;
  DWORD   dwMaxOverlayStretch;
  DWORD   dwMinLiveVideoStretch;
  DWORD   dwMaxLiveVideoStretch;
  DWORD   dwMinHwCodecStretch;
  DWORD   dwMaxHwCodecStretch;
  DWORD   dwReserved1;
  DWORD   dwReserved2;
  DWORD   dwReserved3;
  DWORD   dwSVBCaps;
  DWORD   dwSVBCKeyCaps;
  DWORD   dwSVBFXCaps;
  DWORD   dwSVBRops[DD_ROP_SPACE];
  DWORD   dwVSBCaps;
  DWORD   dwVSBCKeyCaps;
  DWORD   dwVSBFXCaps;
  DWORD   dwVSBRops[DD_ROP_SPACE];
  DWORD   dwSSBCaps;
  DWORD   dwSSBCKeyCaps;
  DWORD   dwSSBFXCaps;
  DWORD   dwSSBRops[DD_ROP_SPACE];
  DWORD   dwReserved4;
  DWORD   dwReserved5;
  DWORD   dwReserved6;
} DDCAPS_DX3;

Membros

dwSize

Tamanho da estrutura, em bytes. Esse membro deve ser inicializado antes que a estrutura seja usada.

dwCaps

Esse valor consiste em um ou mais dos sinalizadores a seguir que especificam recursos de hardware e driver.

DDCAPS_3D

O hardware de exibição tem aceleração 3D.

DDCAPS_ALIGNBOUNDARYDEST

O DirectDraw dá suporte apenas a esses retângulos de destino de sobreposição com o eixo x alinhado aos limites dwAlignBoundaryDest da superfície.

DDCAPS_ALIGNBOUNDARYSRC

O DirectDraw dá suporte apenas a esses retângulos de origem de sobreposição com o eixo x alinhado aos limites dwAlignBoundarySrc da superfície.

DDCAPS_ALIGNSIZEDEST

O DirectDraw dá suporte apenas a esses retângulos de destino de sobreposição cujos tamanhos de eixo x, em pixels, são múltiplos dwAlignSizeDest .

DDCAPS_ALIGNSIZESRC

O DirectDraw dá suporte apenas aos retângulos de origem de sobreposição cujos tamanhos de eixo x, em pixels, são múltiplos dwAlignSizeSrc .

DDCAPS_ALIGNSTRIDE

O DirectDraw cria superfícies de memória de exibição que têm um alinhamento de passo igual ao valor dwAlignStrideAlign .

DDCAPS_ALPHA

O hardware de exibição dá suporte a superfícies somente alfa.

DDCAPS_BANKSWITCHED

O hardware de exibição é alternado por banco e é potencialmente muito lento no acesso aleatório para exibir memória.

DDCAPS_BLT

O hardware de exibição é capaz de operações de transferência de bloco de bits (bitblt).

DDCAPS_BLTCOLORFILL

O hardware de exibição é capaz de preencher cores com um blitter.

DDCAPS_BLTDEPTHFILL

O hardware de exibição é capaz de preencher a profundidade z-buffers com um blitter.

DDCAPS_BLTFOURCC

O hardware de exibição é capaz de conversões de espaço em cores durante operações bitblt.

DDCAPS_BLTQUEUE

O hardware de exibição é capaz de operações bitblt assíncronas.

DDCAPS_BLTSTRETCH

O hardware de exibição é capaz de alongar durante operações bitblt.

DDCAPS_CANBLTSYSMEM

O hardware de exibição é capaz de blitting de ou para a memória do sistema.

DDCAPS_CANCLIP

O hardware de exibição é capaz de recortar com blitting.

DDCAPS_CANCLIPSTRETCHED

O hardware de exibição é capaz de recortar durante a iluminação elástica.

DDCAPS_COLORKEY

Dá suporte a alguma forma de chave de cor em operações de sobreposição ou bitblt. Informações de funcionalidade de chave de cor mais específicas podem ser encontradas no membro dwCKeyCaps .

DDCAPS_COLORKEYHWASSIST

A chave de cor é parcialmente assistida por hardware. Isso significa que outros recursos (CPU ou memória de vídeo) podem ser usados. Se esse bit não estiver definido, o suporte completo ao hardware estará em vigor.

DDCAPS_GDI

O hardware de exibição é compartilhado com a GDI.

DDCAPS_NOHARDWARE

Não há suporte para hardware.

DDCAPS_OVERLAY

O hardware de exibição dá suporte a sobreposições.

DDCAPS_OVERLAYCANTCLIP

O hardware de exibição dá suporte a sobreposições, mas não pode recortá-las.

DDCAPS_OVERLAYFOURCC

O hardware de sobreposição é capaz de conversões de espaço em cores durante operações de sobreposição.

DDCAPS_OVERLAYSTRETCH

O hardware de sobreposição é capaz de alongar. Os membros dwMinOverlayStretch e dwMaxOverlayStretch contêm dados válidos.

DDCAPS_PALETTE

O DirectDraw é capaz de criar e dar suporte a objetos DirectDrawPalette para superfícies diferentes da superfície primária.

DDCAPS_PALETTEVSYNC

O DirectDraw é capaz de atualizar uma paleta sincronizada com a atualização vertical.

DDCAPS_READSCANLINE

O hardware de exibição é capaz de retornar a linha de verificação atual.

DDCAPS_VBI

O hardware de exibição é capaz de gerar uma interrupção em branco vertical.

DDCAPS_ZBLTS

Dá suporte ao uso de buffers z com operações bitblt.

DDCAPS_ZOVERLAYS

Dá suporte ao uso do método IDirectDrawSurface7::UpdateOverlayZOrder como um valor z para sobreposições para controlar suas camadas.

dwCaps2

Esse valor consiste em um ou mais dos sinalizadores a seguir que especificam mais funcionalidades de hardware e driver.

DDCAPS2_AUTOFLIPOVERLAY

A sobreposição pode ser invertida automaticamente para a próxima superfície na cadeia de inversão sempre que ocorrer uma porta de vídeo VSYNC, permitindo que a porta de vídeo e a sobreposição armaguem o vídeo duas vezes sem sobrecarga de CPU. Essa opção só é válida quando a superfície está recebendo dados de uma porta de vídeo. Se os dados da porta de vídeo não estiverem entrelaçados ou não forem intercalados, ele será invertido em cada VSYNC. Se os dados estiverem sendo intercalados na memória, ele será invertido em todos os outros VSYNC.

DDCAPS2_CANBOBHARDWARE

O hardware de sobreposição pode exibir cada campo de um fluxo de vídeo entrelaçado individualmente.

DDCAPS2_CANBOBINTERLEAVED

O hardware de sobreposição pode exibir cada campo de um fluxo de vídeo entrelaçado individualmente enquanto ele é intercalado na memória sem causar artefatos que normalmente podem ocorrer sem suporte especial de hardware. Essa opção só é válida quando a superfície está recebendo dados de uma porta de vídeo e o vídeo é ampliado pelo menos duas vezes na direção vertical.

DDCAPS2_CANBOBNONINTERLEAVED

O hardware de sobreposição pode exibir cada campo de um fluxo de vídeo entrelaçado individualmente enquanto ele não é intercalado na memória sem causar artefatos que normalmente podem ocorrer sem suporte especial de hardware. Essa opção só é válida quando a superfície está recebendo dados de uma porta de vídeo e o vídeo é ampliado pelo menos duas vezes na direção vertical.

DDCAPS2_CANCALIBRATEGAMMA

O sistema tem um calibrador instalado que pode ajustar automaticamente a rampa gama para que o resultado seja idêntico em todos os sistemas que têm um calibrador. Para invocar o calibrador ao definir novos níveis gama, use o sinalizador DDSGR_CALIBRATE ao chamar o método IDirectDrawGammaControl::SetGammaRamp . A calibragem de rampas gama incorre em alguma sobrecarga de processamento e não deve ser usada com frequência.

DDCAPS2_CANDROPZ16BIT

Os valores RGBZ de dezesseis bits podem ser convertidos em valores RGB de 16 bits. (O sistema não dá suporte a conversões de 8 bits.)

DDCAPS2_CANFLIPODDEVEN

O driver é capaz de executar operações ímpares e até mesmo inverter, conforme especificado pelos sinalizadores DDFLIP_ODD e DDFLIP_EVEN que são usados com o método IDirectDrawSurface7::Flip .

DDCAPS2_CANMANAGETEXTURE

O gerenciador de texturas Direct3D usa essa funcionalidade para decidir se deseja colocar superfícies gerenciadas na memória de vídeo não local. Se a funcionalidade estiver definida, o gerenciador de textura colocará superfícies gerenciadas na memória de vídeo não local. Os drivers que não podem textura da memória de vídeo local não devem definir essa funcionalidade.

DDCAPS2_CANRENDERWINDOWED

O driver é capaz de renderizar no modo de janela.

DDCAPS2_CERTIFIED

O hardware de exibição é certificado.

DDCAPS2_COLORCONTROLPRIMARY

A superfície primária contém controles de cor (por exemplo, gama).

DDCAPS2_COLORCONTROLOVERLAY

A superfície de sobreposição contém controles de cores (como brilho e nitidez).

DDCAPS2_COPYFOURCC

O driver dá suporte à iluminação de qualquer superfície FOURCC para outra superfície do mesmo FOURCC.

DDCAPS2_FLIPINTERVAL

O driver responde aos sinalizadores DDFLIP_INTERVAL*. (Para obter mais informações sobre esses sinalizadores, consulte IDirectDrawSurface7::Flip).

DDCAPS2_FLIPNOVSYNC

O driver responde ao sinalizador DDFLIP_NOVSYNC (para obter mais informações sobre esse sinalizador, consulte IDirectDrawSurface7::Flip).

DDCAPS2_NO2DDURING3DSCENE

Operações bidimensionais como IDirectDrawSurface7::Blt e IDirectDrawSurface7::Lock não podem ser executadas em nenhuma superfície que o Direct3D esteja usando entre chamadas para os métodos BeginScene e EndScene .

DDCAPS2_NONLOCALVIDMEM

O driver de vídeo dá suporte a superfícies na memória de vídeo não local.

DDCAPS2_NONLOCALVIDMEMCAPS

As funcionalidades bitblt para superfícies de memória de vídeo não locais diferem das superfícies locais de memória de vídeo. Se esse sinalizador estiver presente, o sinalizador DDCAPS2_NONLOCALVIDMEM também estará presente.

DDCAPS2_NOPAGELOCKREQUIRED

Há suporte para operações bitblt de DMA em superfícies de memória do sistema que não estão bloqueadas por página.

DDCAPS2_PRIMARYGAMMA

Dá suporte a rampas gama dinâmicas para a superfície primária.

DDCAPS2_STEREO

Novo para DirectX 7.0. Ativa o bit dwSVCaps para dar suporte ao modo estéreo. O driver pode fazer estéreo em pelo menos um modo diferente do modo atual. O aplicativo pode usar IDirectDraw7::GetDisplayMode ou IDirectDraw7::EnumDisplayModes para obter informações estéreo por modo.

DDCAPS2_TEXMANINNONLOCALVIDMEM

Novo para DirectX 7.0. O gerenciador de texturas Direct3D usa essa funcionalidade para decidir se deseja colocar superfícies gerenciadas na memória de vídeo não local. Se a funcionalidade estiver definida, o gerenciador de textura colocará superfícies gerenciadas na memória de vídeo não local. Os drivers que não podem textura da memória de vídeo local não devem definir essa funcionalidade.

DDCAPS2_VIDEOPORT

O hardware de exibição dá suporte a vídeo ao vivo.

DDCAPS2_WIDESURFACES

A superfície de exibição dá suporte a superfícies mais largas do que a superfície primária.

dwCKeyCaps

Esse valor consiste em um ou mais dos sinalizadores a seguir que especificam recursos de chave de cor.

DDCKEYCAPS_DESTBLT

Dá suporte a blitting transparente com uma chave de cor que identifica os bits substituíveis da superfície de destino para cores RGB.

DDCKEYCAPS_DESTBLTCLRSPACE

Dá suporte a blitting transparente com um espaço de cor que identifica os bits substituíveis da superfície de destino para cores RGB.

DDCKEYCAPS_DESTBLTCLRSPACEYUV

Dá suporte a blitting transparente com um espaço de cor que identifica os bits substituíveis da superfície de destino para cores YUV.

DDCKEYCAPS_DESTBLTYUV

Dá suporte a blitting transparente com uma chave de cor que identifica os bits substituíveis da superfície de destino para cores YUV.

DDCKEYCAPS_DESTOVERLAY

Dá suporte à sobreposição com o keying de cores dos bits substituíveis da superfície de destino a serem sobrepostos para cores RGB.

DDCKEYCAPS_DESTOVERLAYCLRSPACE

Dá suporte a um espaço de cor como a chave de cor para o destino das cores RGB.

DDCKEYCAPS_DESTOVERLAYCLRSPACEYUV

Dá suporte a um espaço de cor como a chave de cor para o destino das cores YUV.

DDCKEYCAPS_DESTOVERLAYONEACTIVE

Dá suporte a apenas um valor de chave de cor de destino ativo para superfícies de sobreposição visíveis.

DDCKEYCAPS_DESTOVERLAYYUV

Dá suporte à sobreposição, usando a chave de cores dos bits substituíveis da superfície de destino a serem sobrepostos para cores YUV.

DDCKEYCAPS_NOCOSTOVERLAY

Indica que não há compensações de largura de banda para usar a chave de cor com uma sobreposição.

DDCKEYCAPS_SRCBLT

Dá suporte a blitting transparente, usando a chave de cor para a origem com essa superfície para cores RGB.

DDCKEYCAPS_SRCBLTCLRSPACE

Dá suporte a blitting transparente, usando um espaço de cor para a origem com essa superfície para cores RGB.

DDCKEYCAPS_SRCBLTCLRSPACEYUV

Dá suporte a blitting transparente, usando um espaço de cor para a origem com essa superfície para cores YUV.

DDCKEYCAPS_SRCBLTYUV

Dá suporte a blitting transparente, usando a chave de cor para a origem com essa superfície para cores YUV.

DDCKEYCAPS_SRCOVERLAY

Dá suporte à sobreposição, usando a chave de cor para a origem com essa superfície de sobreposição para cores RGB.

DDCKEYCAPS_SRCOVERLAYCLRSPACE

Dá suporte à sobreposição, usando um espaço de cor como a chave de cor de origem para a superfície de sobreposição para cores RGB.

DDCKEYCAPS_SRCOVERLAYCLRSPACEYUV

Dá suporte à sobreposição, usando um espaço de cor como a chave de cor de origem para a superfície de sobreposição para cores YUV.

DDCKEYCAPS_SRCOVERLAYONEACTIVE

Dá suporte a apenas um valor de chave de cor de origem ativo para superfícies de sobreposição visíveis.

DDCKEYCAPS_SRCOVERLAYYUV

Dá suporte à sobreposição, usando a chave de cor para a origem com essa superfície de sobreposição para cores YUV.

dwFXCaps

Esse valor consiste em um ou mais dos sinalizadores a seguir que especificam os recursos de alongamento e efeitos do driver.

DDFXCAPS_BLTALPHA

Dá suporte a operações bitblt de combinação alfa.

DDFXCAPS_BLTARITHSTRETCHY

Usa operações aritméticas, em vez de técnicas de duplicação de pixels, para alongar e reduzir superfícies durante uma operação bitblt. Ocorre ao longo do eixo y (verticalmente).

DDFXCAPS_BLTARITHSTRETCHYN

Usa operações aritméticas, em vez de técnicas de duplicação de pixels, para alongar e reduzir superfícies durante uma operação bitblt. Ocorre ao longo do eixo y (verticalmente) e funciona apenas para alongamento inteiro (×1, ×2 e assim por diante).

DDFXCAPS_BLTFILTER

O driver pode fazer a filtragem de reconstrução de superfície para bitblts distorcidos.

DDFXCAPS_BLTMIRRORLEFTRIGHT

Dá suporte ao espelhamento da esquerda para a direita em uma operação bitblt.

DDFXCAPS_BLTMIRRORUPDOWN

Dá suporte ao espelhamento de cima para baixo em uma operação bitblt.

DDFXCAPS_BLTROTATION

Dá suporte à rotação arbitrária em uma operação bitblt.

DDFXCAPS_BLTROTATION90

Dá suporte a rotações de 90 graus em uma operação bitblt.

DDFXCAPS_BLTSHRINKX

Dá suporte ao encolhimento arbitrário de uma superfície ao longo do eixo x (horizontalmente). Esse sinalizador é válido apenas para operações bitblt.

DDFXCAPS_BLTSHRINKXN

Dá suporte à redução de inteiros (×1, ×2 e assim por diante) de uma superfície ao longo do eixo x (horizontalmente). Esse sinalizador é válido apenas para operações bitblt.

DDFXCAPS_BLTSHRINKY

Dá suporte ao encolhimento arbitrário de uma superfície ao longo do eixo y (verticalmente). Esse sinalizador é válido apenas para operações bitblt.

DDFXCAPS_BLTSHRINKYN

Dá suporte à redução de inteiros (×1, ×2 e assim por diante) de uma superfície ao longo do eixo y (verticalmente). Esse sinalizador é válido apenas para operações bitblt.

DDFXCAPS_BLTSTRETCHX

Dá suporte ao alongamento arbitrário de uma superfície ao longo do eixo x (horizontalmente). Esse sinalizador é válido apenas para operações bitblt.

DDFXCAPS_BLTSTRETCHXN

Dá suporte ao alongamento inteiro (×1, ×2 e assim por diante) de uma superfície ao longo do eixo x (horizontalmente). Esse sinalizador é válido apenas para operações bitblt.

DDFXCAPS_BLTSTRETCHY

Dá suporte ao alongamento arbitrário de uma superfície ao longo do eixo y (verticalmente). Esse sinalizador é válido apenas para operações bitblt.

DDFXCAPS_BLTSTRETCHYN

Dá suporte ao alongamento inteiro (×1, ×2 e assim por diante) de uma superfície ao longo do eixo y (verticalmente). Esse sinalizador é válido apenas para operações bitblt.

DDFXCAPS_BLTTRANSFORM

Dá suporte a transformações geométricas (ou warps) para sprites blitted. Atualmente, não há suporte para transformações em operações bitblt explícitas.

DDFXCAPS_OVERLAYALPHA

Dá suporte à mesclagem alfa para superfícies de sobreposição.

DDFXCAPS_OVERLAYARITHSTRETCHY

Usa operações aritméticas, em vez de técnicas de duplicação de pixels, para alongar e reduzir superfícies de sobreposição. Ocorre ao longo do eixo y (verticalmente).

DDFXCAPS_OVERLAYARITHSTRETCHYN

Usa operações aritméticas, em vez de técnicas de duplicação de pixels, para alongar e reduzir superfícies de sobreposição. Ocorre ao longo do eixo y (verticalmente) e funciona apenas para alongamento inteiro (×1, ×2 e assim por diante).

DDFXCAPS_OVERLAYFILTER

Dá suporte à filtragem de reconstrução de superfície para sprites de sobreposição deformados. Atualmente, não há suporte para filtragem para superfícies de sobreposição exibidas explicitamente (aquelas exibidas com chamadas para IDirectDrawSurface7::UpdateOverlay).

DDFXCAPS_OVERLAYMIRRORLEFTRIGHT

Dá suporte ao espelhamento de sobreposições no eixo vertical.

DDFXCAPS_OVERLAYMIRRORUPDOWN

Dá suporte ao espelhamento de sobreposições no eixo horizontal.

DDFXCAPS_OVERLAYSHRINKX

Dá suporte ao encolhimento arbitrário de uma superfície ao longo do eixo x (horizontalmente). Esse sinalizador é válido apenas para superfícies DDSCAPS_OVERLAY. Esse sinalizador indica apenas as funcionalidades de uma superfície; não indica que a redução está disponível.

DDFXCAPS_OVERLAYSHRINKXN

Dá suporte à redução de inteiros (×1, ×2 e assim por diante) de uma superfície ao longo do eixo x (horizontalmente). Esse sinalizador é válido apenas para superfícies DDSCAPS_OVERLAY. Esse sinalizador indica apenas as funcionalidades de uma superfície; não indica que a redução está disponível.

DDFXCAPS_OVERLAYSHRINKY

Dá suporte ao encolhimento arbitrário de uma superfície ao longo do eixo y (verticalmente). Esse sinalizador é válido apenas para superfícies DDSCAPS_OVERLAY. Esse sinalizador indica apenas as funcionalidades de uma superfície; não indica que a redução está disponível.

DDFXCAPS_OVERLAYSHRINKYN

Dá suporte à redução de inteiros (×1, ×2 e assim por diante) de uma superfície ao longo do eixo y (verticalmente). Esse sinalizador é válido apenas para superfícies DDSCAPS_OVERLAY. Esse sinalizador indica apenas as funcionalidades de uma superfície; não indica que a redução está disponível.

DDFXCAPS_OVERLAYSTRETCHX

Dá suporte ao alongamento arbitrário de uma superfície ao longo do eixo x (horizontalmente). Esse sinalizador é válido apenas para superfícies DDSCAPS_OVERLAY. Esse sinalizador indica apenas as funcionalidades de uma superfície; ele não indica que o alongamento está disponível.

DDFXCAPS_OVERLAYSTRETCHXN

Dá suporte ao alongamento inteiro (×1, ×2 e assim por diante) de uma superfície ao longo do eixo x (horizontalmente). Esse sinalizador é válido apenas para superfícies DDSCAPS_OVERLAY. Esse sinalizador indica apenas as funcionalidades de uma superfície; ele não indica que o alongamento está disponível.

DDFXCAPS_OVERLAYSTRETCHY

Dá suporte ao alongamento arbitrário de uma superfície ao longo do eixo y (verticalmente). Esse sinalizador é válido apenas para superfícies DDSCAPS_OVERLAY. Esse sinalizador indica apenas as funcionalidades de uma superfície; ele não indica que o alongamento está disponível.

DDFXCAPS_OVERLAYSTRETCHYN

Dá suporte ao alongamento inteiro (×1, ×2 e assim por diante) de uma superfície ao longo do eixo y (verticalmente). Esse sinalizador é válido apenas para superfícies DDSCAPS_OVERLAY. Esse sinalizador indica apenas as funcionalidades de uma superfície; ele não indica que o alongamento está disponível.

DDFXCAPS_OVERLAYTRANSFORM

Dá suporte a transformações geométricas (ou warps) para sprites de sobreposição. Atualmente, não há suporte para transformações para superfícies de sobreposição exibidas explicitamente (aquelas exibidas com chamadas para IDirectDrawSurface7::UpdateOverlay).

dwFXAlphaCaps

Esse valor consiste em um ou mais dos sinalizadores a seguir que especificam as funcionalidades alfa do driver.

DDFXALPHACAPS_BLTALPHAEDGEBLEND

Dá suporte à mesclagem alfa ao redor da borda de uma superfície com chave de cor de origem. Usado para operações bitblt.

DDFXALPHACAPS_BLTALPHAPIXELS

Dá suporte a informações alfa no formato de pixel. A profundidade de bit das informações alfa no formato de pixel pode ser 1, 2, 4 ou 8. O valor alfa torna-se mais opaco à medida que o valor alfa aumenta. Independentemente da profundidade das informações alfa, 0 é sempre o valor totalmente transparente. Usado para operações bitblt.

DDFXALPHACAPS_BLTALPHAPIXELSNEG

Dá suporte a informações alfa no formato de pixel. A profundidade de bit das informações alfa no formato de pixel pode ser 1, 2, 4 ou 8. O valor alfa torna-se mais transparente à medida que o valor alfa aumenta. Independentemente da profundidade das informações alfa, 0 é sempre o valor totalmente opaco. Esse sinalizador só poderá ser usado se DDCAPS_ALPHA estiver definido. Usado para operações bitblt.

DDFXALPHACAPS_BLTALPHASURFACES

Dá suporte a superfícies somente alfa. A profundidade de bit de uma superfície somente alfa pode ser 1, 2, 4 ou 8. O valor alfa torna-se mais opaco à medida que o valor alfa aumenta. Independentemente da profundidade das informações alfa, 0 é sempre o valor totalmente transparente. Usado para operações bitblt.

DDFXALPHACAPS_BLTALPHASURFACESNEG

Indica que o canal alfa se torna mais transparente à medida que o valor alfa aumenta. A profundidade dos dados de canal alfa pode ser 1, 2, 4 ou 8. Independentemente da profundidade das informações alfa, 0 é sempre o valor totalmente opaco. Esse sinalizador só poderá ser definido se DDCAPS_ALPHA tiver sido definido. Usado para operações bitblt.

DDFXALPHACAPS_OVERLAYALPHAEDGEBLEND

Dá suporte à mesclagem alfa ao redor da borda de uma superfície com chave de cor de origem. Usado para sobreposições.

DDFXALPHACAPS_OVERLAYALPHAPIXELS

Dá suporte a informações alfa no formato de pixel. A profundidade de bit das informações alfa no formato de pixel pode ser 1, 2, 4 ou 8. O valor alfa torna-se mais opaco à medida que o valor alfa aumenta. Independentemente da profundidade das informações alfa, 0 é sempre o valor totalmente transparente. Usado para sobreposições.

DDFXALPHACAPS_OVERLAYALPHAPIXELSNEG

Dá suporte a informações alfa no formato de pixel. A profundidade de bit das informações alfa no formato de pixel pode ser 1, 2, 4 ou 8. O valor alfa torna-se mais transparente à medida que o valor alfa aumenta. Independentemente da profundidade das informações alfa, 0 é sempre o valor totalmente opaco. Esse sinalizador só poderá ser usado se DDCAPS_ALPHA tiver sido definido. Usado para sobreposições.

DDFXALPHACAPS_OVERLAYALPHASURFACES

Dá suporte a superfícies somente alfa. A profundidade de bit de uma superfície somente alfa pode ser 1, 2, 4 ou 8. O valor alfa torna-se mais opaco à medida que o valor alfa aumenta. Independentemente da profundidade das informações alfa, 0 é sempre o valor totalmente transparente. Usado para sobreposições.

DDFXALPHACAPS_OVERLAYALPHASURFACESNEG

Indica que o canal alfa se torna mais transparente à medida que o valor alfa aumenta. A profundidade dos dados de canal alfa pode ser 1, 2, 4 ou 8. Independentemente da profundidade das informações alfa, 0 é sempre o valor totalmente opaco. Esse sinalizador só poderá ser usado se DDCAPS_ALPHA tiver sido definido. Usado para sobreposições.

dwPalCaps

Esse valor consiste em um ou mais dos sinalizadores a seguir que especificam recursos de paleta.

DDPCAPS_1BIT

Dá suporte a paletas que contêm entradas de cor de 1 bit (duas cores).

DDPCAPS_2BIT

Dá suporte a paletas que contêm entradas de cores de 2 bits (quatro cores).

DDPCAPS_4BIT

Dá suporte a paletas que contêm entradas de cor de 4 bits (16 cores).

DDPCAPS_8BIT

Dá suporte a paletas que contêm entradas de cores de 8 bits (256 cores).

DDPCAPS_8BITENTRIES

Especifica um índice para um índice de cores de 8 bits. Esse campo é válido somente quando usado com a funcionalidade DDPCAPS_1BIT, DDPCAPS_2BIT ou DDPCAPS_4BIT e quando a superfície de destino é de 8 bits por pixel (bpp). Cada entrada de cor tem 1 byte de comprimento e é um índice para uma paleta de 8 bpp na superfície de destino.

DDPCAPS_ALPHA

Dá suporte a paletas que incluem um componente alfa. Para paletas compatíveis com alfa, o membro peFlags de cada estrutura PALETTEENTRY que a paleta contém deve ser interpretado como um único valor alfa de 8 bits (além dos dados de cor nos membros peRed, peGreen e peBlue ). Uma paleta criada com esse sinalizador só pode ser anexada a uma superfície de textura.

DDPCAPS_ALLOW256

Dá suporte a paletas que podem ter todas as 256 entradas definidas.

DDPCAPS_PRIMARYSURFACE

A paleta é anexada à superfície primária. A alteração da paleta tem um efeito imediato na exibição, a menos que a funcionalidade de DDPCAPS_VSYNC seja especificada e tenha suporte.

DDPCAPS_PRIMARYSURFACELEFT

A paleta é anexada à superfície primária à esquerda. A alteração da paleta tem um efeito imediato na exibição, a menos que a funcionalidade de DDPCAPS_VSYNC seja especificada e tenha suporte.

DDPCAPS_VSYNC

A paleta pode ser modificada de forma síncrona com a taxa de atualização do monitor.

dwSVCaps

Esse valor consiste em um ou mais dos sinalizadores a seguir que especificam recursos de visão estéreo.

DDSVCAPS_RESERVED1, DDSVCAPS_RESERVED2, DDSVCAPS_RESERVED3, DDSVCAPS_RESERVED4

Sinalizadores reservados.

DDSVCAPS_STEREOSEQUENTIAL

Novo para DirectX 7.0. O driver pode fazer estéreo em pelo menos um modo diferente do modo atual. O aplicativo pode usar IDirectDraw7::GetDisplayMode ou IDirectDraw7::EnumDisplayModes para obter informações estéreo por modo.

dwAlphaBltConstBitDepths

DDBD_2, DDBD_4 ou DDBD_8. (Indique 2, 4 ou 8 bits por pixel.)

dwAlphaBltPixelBitDepths

DDBD_1, DDBD_2, DDBD_4 ou DDBD_8. (Indique 1, 2, 4 ou 8 bits por pixel.)

dwAlphaBltSurfaceBitDepths

DDBD_1, DDBD_2, DDBD_4 ou DDBD_8. (Indique 1, 2, 4 ou 8 bits por pixel.)

dwAlphaOverlayConstBitDepths

DDBD_2, DDBD_4 ou DDBD_8. (Indique 2, 4 ou 8 bits por pixel.)

dwAlphaOverlayPixelBitDepths

DDBD_1, DDBD_2, DDBD_4 ou DDBD_8. (Indique 1, 2, 4 ou 8 bits por pixel.)

dwAlphaOverlaySurfaceBitDepths

DDBD_1, DDBD_2, DDBD_4 ou DDBD_8. (Indique 1, 2, 4 ou 8 bits por pixel.)

dwZBufferBitDepths

DDBD_8, DDBD_16, DDBD_24 ou DDBD_32. (Indique 8, 16, 24 ou 32 bits por pixel.) Esse membro está obsoleto para o DirectX 6.0 e posterior. Use iDirect3D7::EnumZBufferFormats para recuperar informações sobre formatos de buffer de profundidade com suporte.

dwVidMemTotal

Quantidade total de memória de exibição no dispositivo, em bytes, menos memória reservada para a superfície primária e quaisquer estruturas de dados privadas reservadas pelo driver. (Esse valor é o mesmo que a memória de vídeo total relatada pelo método IDirectDraw7::GetAvailableVidMem .)

dwVidMemFree

Memória de exibição livre. Esse valor é igual ao valor em dwVidMemTotal, menos qualquer memória alocada atualmente pelo aplicativo para superfícies. Ao contrário do método IDirectDraw7::GetAvailableVidMem , que relata a memória disponível para um tipo específico de superfície (como uma textura), esse valor reflete a memória disponível para qualquer tipo de superfície.

dwMaxVisibleOverlays

Número máximo de sobreposições visíveis ou sprites de sobreposição.

dwCurrVisibleOverlays

Número atual de sobreposições visíveis ou sprites de sobreposição.

dwNumFourCCCodes

Número de códigos FourCC.

dwAlignBoundarySrc

Alinhamento de retângulo de origem para uma superfície de sobreposição, em pixels.

dwAlignSizeSrc

Alinhamento do tamanho do retângulo de origem para uma superfície de sobreposição, em pixels. Os retângulos de origem de sobreposição devem ter uma largura de pixel que seja um múltiplo desse valor.

dwAlignBoundaryDest

Alinhamento de retângulo de destino para uma superfície de sobreposição, em pixels.

dwAlignSizeDest

Alinhamento do tamanho do retângulo de destino para uma superfície de sobreposição, em pixels. Retângulos de destino de sobreposição devem ter uma largura de pixel que seja um múltiplo desse valor.

dwAlignStrideAlign

Alinhamento passo a passo.

dwRops[DD_ROP_SPACE]

Operações de varredura com suporte.

ddsCaps

Uma estrutura DDSCAPS2 que contém funcionalidades gerais da superfície.

dwMinOverlayStretch

Fator de alongamento de sobreposição mínimo, multiplicado por 1000. Por exemplo, 1,3 = 1300.

dwMaxOverlayStretch

Fator de alongamento de sobreposição máximo, multiplicado por 1000. Por exemplo, 1,3 = 1300.

dwMinLiveVideoStretch

Obsoleto; não use.

dwMaxLiveVideoStretch

Obsoleto; não use.

dwMinHwCodecStretch

Obsoleto; não use.

dwMaxHwCodecStretch

Obsoleto; não use.

dwReserved1

Reservado

dwReserved2

Reservado

dwReserved3

Reservado

dwSVBCaps

Recursos específicos do driver para bitblts da memória do sistema para exibir memória. Sinalizadores válidos são idênticos aos sinalizadores relacionados a bitblt que são usados com o membro dwCaps .

dwSVBCKeyCaps

Funcionalidades de chave de cor do driver para bitblts da memória do sistema para exibir memória. Sinalizadores válidos são idênticos aos sinalizadores relacionados a bitblt que são usados com o membro dwCKeyCaps .

dwSVBFXCaps

Recursos fx de driver para bitblts da memória do sistema para exibir memória. Sinalizadores válidos são idênticos aos sinalizadores relacionados a bitblt que são usados com o membro dwFXCaps .

dwSVBRops[DD_ROP_SPACE]

Operações de varredura com suporte para bitblts da memória do sistema para exibir memória.

dwVSBCaps

Recursos específicos do driver para bitblts da memória de exibição para a memória do sistema. Sinalizadores válidos são idênticos aos sinalizadores relacionados a bitblt que são usados com o membro dwCaps .

dwVSBCKeyCaps

Recursos de chave de cor do driver para bitblts da memória de exibição para a memória do sistema. Sinalizadores válidos são idênticos aos sinalizadores relacionados a bitblt que são usados com o membro dwCKeyCaps .

dwVSBFXCaps

Recursos fx de driver para bitblts da memória de exibição para a memória do sistema. Sinalizadores válidos são idênticos aos sinalizadores relacionados a bitblt usados com o membro dwFXCaps .

dwVSBRops[DD_ROP_SPACE]

Operações de varredura com suporte para bitblts da memória de exibição para a memória do sistema.

dwSSBCaps

Recursos específicos do driver para bitblts da memória do sistema para a memória do sistema. Os sinalizadores válidos são idênticos aos sinalizadores relacionados a bitblt usados com o membro dwCaps .

dwSSBCKeyCaps

Recursos de chave de cor do driver para bitblts da memória do sistema para a memória do sistema. Sinalizadores válidos são idênticos aos sinalizadores relacionados a bitblt usados com o membro dwCKeyCaps .

dwSSBFXCaps

Recursos fx de driver para bitblts da memória do sistema para a memória do sistema. Sinalizadores válidos são idênticos aos sinalizadores relacionados a bitblt usados com o membro dwFXCaps .

dwSSBRops[DD_ROP_SPACE]

Operações de varredura com suporte para bitblts da memória do sistema para a memória do sistema.

dwReserved4

Reservado

dwReserved5

Reservado

dwReserved6

Reservado

Comentários

Para compatibilidade com versões anteriores, o arquivo de cabeçalho Ddraw.h contém várias definições da estrutura DDCAPS. A versão que passa o pré-processador é determinada pelo valor da constante DIRECTDRAW_VERSION.

Requisitos

Cabeçalho	ddraw.h