D3DMSWAPEFFECT

9/8/2008

Essa enumeração fornece valores para identificar as maneiras possíveis para apresentar uma cena. Essa enumeração é usada na SwapEffect membro das D3DMPRESENT_PARAMETERS estrutura.

Syntax

typedef enum _D3DMSWAPEFFECT {
  D3DMSWAPEFFECT_DISCARD     = 1,
  D3DMSWAPEFFECT_FLIP        = 2,
  D3DMSWAPEFFECT_COPY        = 3,
  D3DMSWAPEFFECT_COPY_VSYNC  = 4,
  D3DMSWAPEFFECT_FORCE_ULONG = 0x7fffffff,
} D3DMSWAPEFFECT;

Elementos

• D3DMSWAPEFFECT_DISCARD
  Indica um método apresentação usado como um mecanismo desempenho pois ele torna não suposições sobre o conteúdo do buffer de fundo descartada. Após o buffer de fundo é copiado para a Tela seu conteúdo é indefinido. Este método apresentação só é evidente na depuração compilações do Mobile Direct3D. A operação copiar é sincronizado com o vertical refazer.

• D3DMSWAPEFFECT_FLIP
  Indica que a frente e voltar buffers são trocados. Essa operação é executada durante o retrace vertical período. Além disso, esta operação requer que a frente e voltar buffers têm o mesmas dimensões e formatos pixel. Este método apresentação não é permitido se o aplicativo especifica suavização multisampling.

• D3DMSWAPEFFECT_COPY
  Indica que o buffer de fundo é copiados para a reserva frontal. Os parâmetros retângulo origem e destino para o IDirect3DMobileDevice::Present chamar pode ser usado para especificar retângulos para mover. Se os retângulos não forem o mesmo tamanho, a imagem buffer de fundo é reduzida ou alongada para caber. A operação copiar é executada tão logo seja possível e não sincronizado com o sincronizar vertical.

• D3DMSWAPEFFECT_COPY_VSYNC
  Indica uma apresentação método idêntico ao D3DMSWAPEFFECT_COPY, exceto a operação copiar é executada durante o vertical refazer período.

• D3DMSWAPEFFECT_FORCE_ULONG
  Força o compilador para interpretar a enumeração como um valor ULONG. Este valor não é usada diretamente na programação do Mobile Direct3D.

Remarks

Todas as operações que são sincronizadas com o vertical refazer período respeito a FullScreen_PresentationInterval membro das D3DMPRESENT_PARAMETERS estrutura. Se esse membro estrutura é definido como 0, significa que um intervalo de 1 é assumido.

O estado do buffer de fundo após um chamar para IDirect3DMobileDevice::Present é bem definido por cada um desses efeitos trocar, e se o dispositivo Microsoft® Direct3D Mobile® foi criado com um total-uma em janela ou Tela trocar encadear encadear trocar não tem nenhum efeito sobre esse estado.

Em particular, o efeito trocar D3DMSWAPEFFECT_FLIP opera o mesmo se completo ou em janela-Tela e o Direct3D Middleware Mobile garante isso criando adicional buffers. Como resultado, é recomendável que os aplicativos usam D3DMSWAPEFFECT_DISCARD sempre que possível para evitar qualquer tais punições. Isso ocorre porque esse efeito trocar sempre será a mais eficiente em termos de consumo memória e desempenho.

Requirements

Header	d3dmtypes.h
Windows Embedded CE	Windows CE 5.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later

See Also

Reference

Direct3D Mobile Enumerations
D3DMPRESENT_PARAMETERS
IDirect3DMobileDevice::Present

Concepts

Scene Presentation