Compartir a través de

estructura D3DDDIARG_CLEAR (d3dumddi.h)

  • Artículo

La estructura D3DDDIARG_CLEAR describe los parámetros de una operación de borrado asistido por hardware.

Sintaxis

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

Miembros

[in] Flags

Valor UINT que especifica qué búferes debe borrar el controlador y cómo se debe realizar la operación de borrado. Este miembro puede ser un OR bit a bit de los valores siguientes. Para obtener más información, vea la sección Comentarios en la página Borrar referencia.

Valor Significado
D3DCLEAR_TARGET (0x00000001l) El controlador debe borrar el destino de representación del contexto al color especificado por el miembro FillColor. Este valor se define en D3d8types.h.
D3DCLEAR_STENCIL (0x00000004l) El controlador debe borrar el búfer de galería de símbolos del contexto al valor especificado por el miembro FillStencil. Este valor se define en D3d8types.h.
D3DCLEAR_ZBUFFER (0x00000002l) El controlador debe borrar el búfer de profundidad del contexto a la profundidad especificada por el miembro FillDepth. Este valor se define en D3d8types.h.
D3DCLEAR_COMPUTERECTS (0x00000008l) Si se especifican rectángulos para borrarlos, el controlador debe recortarlos en la ventanilla actual. Si no se especifican rectángulos, el controlador debe borrar toda la ventanilla. Este valor se define en D3dhal.h.

[in] FillColor

Valor de color en el que el controlador debe borrar el destino de representación del contexto.

[in] FillDepth

Valor que el controlador debe usar para establecer la profundidad en el búfer de profundidad del contexto. Este miembro puede ser un valor del intervalo comprendido entre 0,0 y 1,0.

[in] FillStencil

Valor en el que el controlador debe borrar el búfer de galería de símbolos del contexto. Este miembro puede ser un entero del intervalo comprendido entre 0 y 2ⁿ-1, donde n es el número de bits en el búfer de galería de símbolos.

Comentarios

En una llamada a la función Clear del controlador de visualización en modo de usuario, se pasa un puntero a una estructura de D3DDDIARG_CLEAR en el parámetro pData . El tiempo de ejecución de Microsoft Direct3D pasa información a los parámetros NumRect y pRect en una llamada a la función Clear del controlador de visualización en modo de usuario para especificar las áreas rectangulares del búfer que el controlador debe borrar.

Requisitos

Requisito Value
Cliente mínimo compatible Disponible en Windows Vista y versiones posteriores de los sistemas operativos Windows.
Encabezado d3dumddi.h (incluya D3dumddi.h)

Consulte también

Borrar