Share via

D3DHAL_DP2CLEAR

  • Article

This structure contains all of the information that the driver needs to perform hardware-assisted clearing on the rendering target, depth buffer or stencil buffer.

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

Members

  • dwFlags
    Specifies what buffer(s) the driver should clear. This member can be a bitwise OR of the following values.

    Value Description
    D3DCLEAR_TARGET The driver should clear the context's render target to the color specified by the dwFillColor member.
    D3DCLEAR_STENCIL The driver should clear the context's stencil buffer to the value specified by the dwFillStencil member.
    D3DCLEAR_ZBUFFER The driver should clear the context's depth buffer to the depth specified by the dwFillDepth member.
    D3DCLEAR_COMPUTERECTS If this flag is set, the specified rectangles should be clipped against the current viewport. Furthermore, it is possible that when D3DCLEAR_COMPUTERECTS is specified the number of rectangles to clear can be zero (the number of rectangles to clear can be found in the wStateCount/wPrimtiveCount union of the D3DHAL_DP2COMMAND structure for the clear). In this case the entire viewport should be cleared.

  • dwFillColor
    Specifies the color that the driver should clear the context's render target to.

  • dvFillDepth
    Specifies the value that the driver should use to set the depth in the context's depth buffer. This member can be a value in the interval 0.0 to 1.0. The driver should convert this value to an integer using the dwZBitMask member of the depth buffer's DDPIXELFORMAT structure.

  • dwFillStencil
    Specifies the value that the driver should clear the context's stencil buffer to. This member can be an integer in the interval zero to 2n-1, where n is the number of bits in the stencil buffer.

  • Rects
    Specifies the rectangular areas of the buffer that the driver should clear. The rectangles are specified in screen coordinates. This member of the structure contains the first rectangle area to be blitted. The wStateCount member of the D3DHAL_DP2COMMAND contains the total number of rectangle areas to be blitted. The other (wStateCount-1) RECT structures required will follow the D3DHAL_DP2CLEAR structure without any padding.

Remarks

This structure is used with the D3DDP2OP_CLEAR command token to replace the legacy D3dClear and D3dClear2 callbacks.

When the number of rectangles is zero, the D3DHAL_DP2CLEAR data structure still includes space for a single RECT. Thus, the size of this single RECT should be included when advancing to the next DP2 instruction. However, the contents of the RECT in this case are undefined and the driver should not attempt to read them.

Requirements

OS Versions: Windows CE .NET 4.0 and later.
Header: D3dhal.h.

See Also

D3DHAL_DP2COMMAND | DDPIXELFORMAT | D3DHAL_DP2COMMAND | D3DDP2OP_CLEAR | D3DHAL_XXX Structures

 Last updated on Tuesday, May 18, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.