estructura D3DHAL_DP2CLEAR (d3dhal.h)

D3DHAL_DP2CLEAR contiene toda la información que el controlador necesita para realizar la desactivación asistida por hardware en el destino de representación, el búfer de profundidad o el búfer de galería de símbolos.

Sintaxis

typedef struct _D3DHAL_DP2CLEAR {
  DWORD    dwFlags;
  DWORD    dwFillColor;
  D3DVALUE dvFillDepth;
  DWORD    dwFillStencil;
  RECT     Rects[1];
} D3DHAL_DP2CLEAR;

Miembros

dwFlags

Especifica qué búferes debe borrar el controlador. Este miembro puede ser un OR bit a bit de los siguientes valores:

Valor	Significado
D3DCLEAR_TARGET	El controlador debe borrar el destino de representación del contexto al color especificado por el miembro dwFillColor.
D3DCLEAR_STENCIL	El controlador debe borrar el búfer de galería de símbolos del contexto en el valor especificado por el miembro dwFillStencil.
D3DCLEAR_ZBUFFER	El controlador debe borrar el búfer de profundidad del contexto a la profundidad especificada por el miembro dwFillDepth.
D3DCLEAR_COMPUTERECTS	DirectX 8.0 y versiones posteriores solo. Si se establece esta marca, los rectángulos especificados se deben recortar en la ventanilla actual. Además, es posible que cuando se especifique D3DCLEAR_COMPUTERECTS el número de rectángulos que se van a borrar puede ser cero (el número de rectángulos que se van a borrar se puede encontrar en la unión wStateCount/wPrimtiveCount de la estructura de D3DHAL_DP2COMMAND para el borrado). En este caso, se debe borrar toda la ventanilla.

dwFillColor

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

dvFillDepth

Especifica el 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 de 0,0 a 1,0. El controlador debe convertir este valor en un entero mediante el miembro dwZBitMask de la estructura DDPIXELFORMAT del búfer de profundidad.

dwFillStencil

Especifica el 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 entre 0 y 2ⁿ-1, donde n es el número de bits del búfer de galería de símbolos.

Rects[1]

Especifica las áreas rectangulares del búfer que el controlador debe borrar. Los rectángulos se especifican en coordenadas de pantalla. Este miembro de la estructura contiene el primer área de rectángulo que se va a dividir. El miembro wStateCount del D3DHAL_DP2COMMAND contiene el número total de áreas rectángulo que se van a dividir. Las demás estructuras RECT (wStateCount-1) necesarias siguen la estructura de D3DHAL_DP2CLEAR sin relleno.

Comentarios

Esta estructura se usa con el token de comando de D3DDP2OP_CLEAR para reemplazar las devoluciones de llamada D3dClear y D3dClear2 heredadas.

Es importante tener en cuenta que, cuando el número de rectángulos es cero, la estructura de datos D3DHAL_DP2CLEAR todavía incluye espacio para un único RECT. Por lo tanto, el tamaño de este único RECT debe incluirse al avanzar a la siguiente instrucción DP2. Sin embargo, el contenido del RECT en este caso no está definido y el controlador no debe intentar leerlos.

Los controladores de pantalla deben convertir los valores de color de entrada para las clases ARGB y YUV de formatos de color. Para las operaciones claras, los valores de color de entrada se especifican en el miembro dwFillColor . Para obtener más información, vea Control de valores de color para formatos de píxeles.

Requisitos

Requisito	Valor
Header	d3dhal.h (incluya D3dhal.h)

Consulte también

D3DDP2OP_CLEAR

D3DHAL_DP2COMMAND

DDPIXELFORMAT