DXGK_GDIARG_COLORFILL structure (d3dkmddi.h)

The DXGK_GDIARG_COLORFILL structure describes the characteristics of a GDI hardware-accelerated color fill operation.

Syntax

typedef struct _DXGK_GDIARG_COLORFILL {
  [in] RECT DstRect;
       UINT DstAllocationIndex;
       UINT NumSubRects;
       RECT *pSubRects;
       UINT Color;
       WORD Rop;
       WORD Rop3;
} DXGK_GDIARG_COLORFILL;

Members

[in] DstRect

A RECT structure that defines the rectangular area to be modified. This rectangle is specified in the coordinate system of the destination surface and is defined by two points: upper left and lower right. The rectangle is lower-right exclusive; that is, its lower and right edges are not a part of the bit-block transfer. The two points that define the rectangle are always well ordered.

The destination rectangle defined by DstRect can exceed the bounds of the destination surface, but sub-rectangles cannot. Additionally, all sub-rectangles are guaranteed to fit inside the destination surface. Sub-rectangles can be constrained further by a bounding rectangle that is smaller than the destination rectangle.

DstAllocationIndex

[in] An index of the element in the allocation list that specifies the allocation that is referenced by the DstRect destination rectangle.

NumSubRects

[in] The number of sub-rectangles in the destination surface space. The sub-rectangles are not tightly bounded by the DstRect destination rectangle.

pSubRects

[in] A pointer to the sub-rectangles in the destination surface space that is bounded by the DstRect destination rectangle.

Color

[in] The fill color, in 32-bit ARGB unsigned pixel format (as defined by the D3DDDIFMT_A8R8G8B8 value of the D3DDDIFORMAT enumeration).

Rop

[in] An 8-bit value that specifies a GDI raster operation (ROP) that is defined by the constant values of the DXGK_GDIROP_COLORFILL enumeration.

Rop3

[in] An 8-bit value that specifies a ternary GDI raster operation (ROP3) that combines a brush, a source bitmap, and a destination bitmap in one of 256 possible combinations. This type of raster operation will be processed only if the driver has set the SupportAllBltRops member in the DXGK_PRESENTATIONCAPS structure.

Requirements

Requirement Value
Minimum supported client Windows 7
Header d3dkmddi.h (include D3dkmddi.h)

See also

D3DDDIFORMAT

DXGK_GDIROP_COLORFILL

DXGK_PRESENTATIONCAPS

RECT