D3DHAL_DP2COLORFILL structure (d3dhal.h)

DirectX 9.0 and later versions only.

D3DHAL_DP2COLORFILL is used for color-fill operations when D3dDrawPrimitives2 responds to the D3DDP2OP_COLORFILL command token.

Syntax

typedef struct _D3DHAL_DP2COLORFILL {
  DWORD    dwSurface;
  RECTL    rRect;
  D3DCOLOR Color;
} D3DHAL_DP2COLORFILL;

Members

dwSurface

Specifies the handle to the surface to be filled.

rRect

Specifies a RECTL structure that specifies the upper left and lower right points of a rectangle on the surface to be filled.

Color

Specifies a D3DCOLOR for the color type.

Remarks

Because DirectX 9.0 and later drivers are required to support the D3DDP2OP_COLORFILL command token, they are not required to expose a capability bit that indicates such support.

Display drivers must convert input color values for the ARGB and YUV classes of color formats. For color-fill operations, input color values are specified in the Color member. For more information, see Handling Color Values for Pixel Formats.

When the runtime calls a driver's DdBlt function to perform a color-fill operation, the runtime converts the D3DCOLOR value to an explicit pixel value if the runtime supports the format of that D3DCOLOR value. If the runtime does not support the format, the D3DCOLOR value is passed directly to the driver.

For more information about D3DCOLOR, see the DirectX SDK documentation.

Requirements

Requirement Value
Header d3dhal.h (include D3dhal.h)

See also

D3DDP2OP_COLORFILL

D3dDrawPrimitives2

DdBlt