| UID | title | description | old-location | tech.root | ms.date | keywords | ms.keywords | req.header | req.include-header | req.target-type | req.target-min-winverclnt | req.target-min-winversvr | req.kmdf-ver | req.umdf-ver | req.ddi-compliance | req.unicode-ansi | req.idl | req.max-support | req.namespace | req.assembly | req.type-library | req.lib | req.dll | req.irql | targetos | req.typenames | f1_keywords | topic_type | api_type | api_location | api_name | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
NS:d3dumddi._D3DDDIARG_CLEAR |
_D3DDDIARG_CLEAR (d3dumddi.h) |
The D3DDDIARG_CLEAR structure describes the parameters of a hardware-assisted clearing operation. |
display\d3dddiarg_clear.htm |
display |
05/10/2018 |
|
D3DDDIARG_CLEAR, D3DDDIARG_CLEAR structure [Display Devices], UMDisplayDriver_param_Structs_64efff84-8fe3-40d4-b823-27e4a235fd86.xml, _D3DDDIARG_CLEAR, d3dumddi/D3DDDIARG_CLEAR, display.d3dddiarg_clear |
d3dumddi.h |
D3dumddi.h |
Windows |
Available in Windows Vista and later versions of the Windows operating systems. |
Windows |
D3DDDIARG_CLEAR |
|
|
|
|
|
The D3DDDIARG_CLEAR structure describes the parameters of a hardware-assisted clearing operation.
A UINT value that specifies which buffers the driver should clear and how the clear operation should be performed. This member can be a bitwise OR of the following values. For more information, see the Remarks section in the Clear reference page.
| Value | Meaning |
|---|---|
| D3DCLEAR_TARGET (0x00000001l) | The driver should clear the context's render target to the color that is specified by the FillColor member. This value is defined in D3d8types.h. |
| D3DCLEAR_STENCIL (0x00000004l) | The driver should clear the context's stencil buffer to the value that is specified by the FillStencil member. This value is defined in D3d8types.h. |
| D3DCLEAR_ZBUFFER (0x00000002l) | The driver should clear the context's depth buffer to the depth that is specified by the FillDepth member. This value is defined in D3d8types.h. |
| D3DCLEAR_COMPUTERECTS (0x00000008l) | If rectangles are specified for clearing, the driver should clip them against the current viewport. If no rectangles are specified, the driver should clear the entire viewport. This value is defined in D3dhal.h. |
The color value that the driver should clear the context's render target to.
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 range from 0.0 through 1.0.
The value that the driver should clear the context's stencil buffer to. This member can be an integer in the range from 0 through 2ⁿ-1, where n is the number of bits in the stencil buffer.
In a call to the user-mode display driver's Clear function, a pointer to a D3DDDIARG_CLEAR structure is passed in the pData parameter. The Microsoft Direct3D runtime passes information to the NumRect and pRect parameters in a call to the user-mode display driver's Clear function to specify the rectangular areas of the buffer that the driver should clear.