Compartilhar via

estrutura D3DDDIARG_CLEAR (d3dumddi.h)

  • Artigo

A estrutura D3DDDIARG_CLEAR descreve os parâmetros de uma operação de limpeza assistida por hardware.

Sintaxe

typedef struct _D3DDDIARG_CLEAR {
  [in] UINT  Flags;
  [in] UINT  FillColor;
  [in] FLOAT FillDepth;
  [in] UINT  FillStencil;
} D3DDDIARG_CLEAR;

Membros

[in] Flags

Um valor UINT que especifica quais buffers o driver deve limpar e como a operação de limpeza deve ser executada. Esse membro pode ser um OR bit a bit dos valores a seguir. Para obter mais informações, consulte a seção Comentários na página Limpar referência.

Valor Significado
D3DCLEAR_TARGET (0x00000001l) O driver deve limpar o destino de renderização do contexto para a cor especificada pelo membro FillColor. Esse valor é definido em D3d8types.h.
D3DCLEAR_STENCIL (0x00000004l) O driver deve limpar o buffer de estêncil do contexto para o valor especificado pelo membro FillStencil. Esse valor é definido em D3d8types.h.
D3DCLEAR_ZBUFFER (0x00000002l) O driver deve limpar o buffer de profundidade do contexto para a profundidade especificada pelo membro FillDepth. Esse valor é definido em D3d8types.h.
D3DCLEAR_COMPUTERECTS (0x00000008l) Se os retângulos forem especificados para limpeza, o driver deverá recortá-los no visor atual. Se nenhum retângulo for especificado, o driver deverá limpar todo o visor. Esse valor é definido em D3dhal.h.

[in] FillColor

O valor de cor para o qual o driver deve limpar o destino de renderização do contexto.

[in] FillDepth

O valor que o driver deve usar para definir a profundidade no buffer de profundidade do contexto. Esse membro pode ser um valor no intervalo de 0,0 a 1,0.

[in] FillStencil

O valor para o qual o driver deve limpar o buffer de estêncil do contexto. Esse membro pode ser um inteiro no intervalo de 0 a 2ⁿ-1, em que n é o número de bits no buffer de estêncil.

Comentários

Em uma chamada para a função Clear do driver de exibição no modo de usuário, um ponteiro para uma estrutura D3DDDIARG_CLEAR é passado no parâmetro pData . O runtime do Microsoft Direct3D passa informações para os parâmetros NumRect e pRect em uma chamada para a função Clear do driver de exibição no modo de usuário para especificar as áreas retangulares do buffer que o driver deve limpar.

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível no Windows Vista e versões posteriores dos sistemas operacionais Windows.
Cabeçalho d3dumddi.h (inclua D3dumddi.h)

Confira também

Limpar