estrutura D3DPRESENT_PARAMETERS

Descreve os parâmetros de apresentação.

Sintaxe

typedef struct D3DPRESENT_PARAMETERS {
  UINT                BackBufferWidth;
  UINT                BackBufferHeight;
  D3DFORMAT           BackBufferFormat;
  UINT                BackBufferCount;
  D3DMULTISAMPLE_TYPE MultiSampleType;
  DWORD               MultiSampleQuality;
  D3DSWAPEFFECT       SwapEffect;
  HWND                hDeviceWindow;
  BOOL                Windowed;
  BOOL                EnableAutoDepthStencil;
  D3DFORMAT           AutoDepthStencilFormat;
  DWORD               Flags;
  UINT                FullScreen_RefreshRateInHz;
  UINT                PresentationInterval;
} D3DPRESENT_PARAMETERS, *LPD3DPRESENT_PARAMETERS;

Membros

BackBufferWidth

Tipo: UINT

Largura dos buffers traseiros da nova cadeia de troca, em pixels. Se Windowed for FALSE (a apresentação é de tela inteira), esse valor deverá ser igual à largura de um dos modos de exibição enumerados encontrados por meio de EnumAdapterModes. Se Windowed for TRUE e BackBufferWidth ou BackBufferHeight for zero, a dimensão correspondente da área de cliente do hDeviceWindow (ou a janela de foco, se hDeviceWindow for NULL) será tomada.

BackBufferHeight

Tipo: UINT

Altura dos buffers traseiros da nova cadeia de troca, em pixels. Se Windowed for FALSE (a apresentação é de tela inteira), esse valor deverá ser igual à altura de um dos modos de exibição enumerados encontrados por meio de EnumAdapterModes. Se Windowed for TRUE e BackBufferWidth ou BackBufferHeight for zero, a dimensão correspondente da área de cliente do hDeviceWindow (ou a janela de foco, se hDeviceWindow for NULL) será tomada.

BackBufferFormat

Tipo: D3DFORMAT

O formato de buffer traseiro. Para obter mais informações sobre formatos, consulte D3DFORMAT. Esse valor deve ser um dos formatos de destino de renderização, conforme validado por CheckDeviceType. Você pode usar GetDisplayMode para obter o formato atual.

Na verdade, D3DFMT_UNKNOWN pode ser especificado para o BackBufferFormat enquanto estiver no modo com janelas. Isso informa ao runtime para usar o formato atual do modo de exibição e elimina a necessidade de chamar GetDisplayMode.

Para aplicativos com janelas, o formato de buffer traseiro não precisa mais corresponder ao formato de modo de exibição porque a conversão de cores agora pode ser feita pelo hardware (se o hardware der suporte à conversão de cores). O conjunto de possíveis formatos de buffer traseiro é restrito, mas o runtime permitirá que qualquer formato de buffer voltar válido seja apresentado a qualquer formato de área de trabalho. (Há o requisito adicional de que o dispositivo seja operável na área de trabalho; os dispositivos normalmente não operam em modos de 8 bits por pixel.)

Aplicativos de tela inteira não podem fazer conversão de cores.

BackBufferCount

Tipo: UINT

Esse valor pode estar entre 0 e D3DPRESENT_BACK_BUFFERS_MAX (ou D3DPRESENT_BACK_BUFFERS_MAX_EX ao usar Direct3D 9Ex). Os valores de 0 são tratados como 1. Se o número de buffers traseiros não puder ser criado, o runtime falhará na chamada de método e preencherá esse valor com o número de buffers de fundo que podem ser criados. Como resultado, um aplicativo pode chamar o método duas vezes com a mesma estrutura D3DPRESENT_PARAMETERS e esperar que ele funcione na segunda vez.

O método falhará se um buffer de fundo não puder ser criado. O valor de BackBufferCount influencia qual conjunto de efeitos de troca são permitidos. Especificamente, qualquer efeito de troca de D3DSWAPEFFECT_COPY requer que haja exatamente um buffer traseiro.

Multisampletype

Tipo: D3DMULTISAMPLE_TYPE

Membro do tipo enumerado D3DMULTISAMPLE_TYPE . O valor deve ser D3DMULTISAMPLE_NONE, a menos que SwapEffect tenha sido definido como D3DSWAPEFFECT_DISCARD. Há suporte para multisampling somente se o efeito de troca for D3DSWAPEFFECT_DISCARD.

MultiSampleQuality

Tipo: DWORD

Nível de qualidade. O intervalo válido está entre zero e um a menos do que o nível retornado por pQualityLevels usado por CheckDeviceMultiSampleType. Passar um valor maior retorna o erro D3DERR_INVALIDCALL. Os valores emparelhados de destinos de renderização ou de superfícies de estêncil de profundidade e D3DMULTISAMPLE_TYPE devem corresponder.

Swapeffect

Tipo: D3DSWAPEFFECT

Membro do tipo enumerado D3DSWAPEFFECT . O runtime garantirá a semântica implícita relativa ao comportamento de troca de buffer; Portanto, se Windowed for TRUE e SwapEffect estiver definido como D3DSWAPEFFECT_FLIP, o runtime criará um buffer de back extra e copiará o que se tornar o buffer frontal no momento da apresentação.

D3DSWAPEFFECT_COPY requer que BackBufferCount seja definido como 1.

D3DSWAPEFFECT_DISCARD será imposta no runtime de depuração preenchendo qualquer buffer com ruído após a apresentação.

Diferenças entre Direct3D9 e Direct3D9Ex:

  • No Direct3D9Ex, D3DSWAPEFFECT_FLIPEX é adicionado para designar quando um aplicativo está adotando o modo de inversão. Ou seja, o quadro de um aplicativo é passado no modo da janela (em vez de copiado) para o DWM (Gerenciador de Janelas da Área de Trabalho) para composição. O modo flip fornece largura de banda de memória mais eficiente e permite que um aplicativo aproveite as estatísticas presentes na tela inteira. Ele não altera o comportamento em tela inteira. O comportamento do modo inverso está disponível a partir do Windows 7.

 

hDeviceWindow

Tipo: HWND

A janela do dispositivo determina o local e o tamanho do buffer traseiro na tela. Isso é usado pelo Direct3D quando o conteúdo do buffer traseiro é copiado para o buffer frontal durante o Present.

  • Para um aplicativo de tela inteira, esse é um identificador para a janela superior (que é a janela de foco).

    Para aplicativos que usam vários dispositivos de tela inteira (como um sistema multimonitor), exatamente um dispositivo pode usar a janela de foco como a janela do dispositivo. Todos os outros dispositivos devem ter janelas de dispositivo exclusivas.

  • Para um aplicativo de modo com janelas, esse identificador será a janela de destino padrão do Present. Se esse identificador for NULL, a janela de foco será tomada.

Observe que nenhuma tentativa é feita pelo runtime para refletir as alterações do usuário no tamanho da janela. O buffer traseiro não é redefinido implicitamente quando essa janela é redefinida. No entanto, o método Present controla automaticamente as alterações de posição da janela.

Janela

Tipo: BOOL

TRUE se o aplicativo for executado em janelas; FALSE se o aplicativo for executado em tela inteira.

EnableAutoDepthStencil

Tipo: BOOL

Se esse valor for TRUE, o Direct3D gerenciará buffers de profundidade para o aplicativo. O dispositivo criará um buffer de estêncil de profundidade quando for criado. O buffer de estêncil de profundidade será definido automaticamente como o destino de renderização do dispositivo. Quando o dispositivo for redefinido, o buffer de estêncil de profundidade será automaticamente destruído e recriado no novo tamanho.

Se EnableAutoDepthStencil for TRUE, AutoDepthStencilFormat deverá ser um formato válido de estêncil de profundidade.

AutoDepthStencilFormat

Tipo: D3DFORMAT

Membro do tipo enumerado D3DFORMAT . O formato da superfície de estêncil de profundidade automática que o dispositivo criará. Esse membro é ignorado, a menos que EnableAutoDepthStencil seja TRUE.

Sinalizadores

Tipo: DWORD

Uma das constantes D3DPRESENTFLAG .

FullScreen_RefreshRateInHz

Tipo: UINT

A taxa na qual o adaptador de exibição atualiza a tela. O valor depende do modo no qual o aplicativo está em execução:

  • Para o modo com janelas, a taxa de atualização deve ser 0.
  • Para o modo de tela inteira, a taxa de atualização é uma das taxas de atualização retornadas por EnumAdapterModes.

PresentationInterval

Tipo: UINT

A taxa máxima na qual os buffers traseiros da cadeia de troca podem ser apresentados ao buffer frontal. Para obter uma explicação detalhada dos modos e dos intervalos com suporte, consulte D3DPRESENT.

Requisitos

Requisito Valor
parâmetro
D3D9Types.h

Confira também

Estruturas Direct3D

Createdevice

CreateAdditionalSwapChain

Presente

Redefinir