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