Expand Minimize

DXGK_GDIARG_COLORFILL structure

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

Syntax


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

Members

DstRect

[in] 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

Version

Available in Windows 7 and later versions of the Windows operating systems.

Header

D3dkmddi.h (include D3dkmddi.h)

See also

D3DDDIFORMAT
DXGK_GDIROP_COLORFILL
DXGK_PRESENTATIONCAPS
RECT

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft