Edit

DXGK_RENDERKM_COMMAND structure (d3dkmddi.h)

  • Article

The DXGK_RENDERKM_COMMAND structure is used to construct a command buffer to control GDI hardware-accelerated rendering.

Syntax

typedef struct _DXGK_RENDERKM_COMMAND {
  DXGK_RENDERKM_OPERATION OpCode;
  UINT                    CommandSize;
  union {
    DXGK_GDIARG_BITBLT         BitBlt;
    DXGK_GDIARG_COLORFILL      ColorFill;
    DXGK_GDIARG_ALPHABLEND     AlphaBlend;
    DXGK_GDIARG_STRETCHBLT     StretchBlt;
    DXGK_GDIARG_TRANSPARENTBLT TransparentBlt;
    DXGK_GDIARG_CLEARTYPEBLEND ClearTypeBlend;
  } Command;
} DXGK_RENDERKM_COMMAND;

Members

OpCode

[in] A DXGK_RENDERKM_OPERATION-type operation code that identifies the GDI hardware-accelerated rendering operation to process. For more information about GDI hardware acceleration, see the Remarks section.

CommandSize

[in] The size of the current command, in bytes. This is equal to the number of bytes from the beginning of DXGK_RENDERKM_COMMAND up to the next command.

Command

The command.

Command.BitBlt

[in] A bit-block transfer (bitblt) that is described by a DXGK_GDIARG_BITBLT structure.

Command.ColorFill

[in] A color fill that is described by a DXGK_GDIARG_COLORFILL structure.

Command.AlphaBlend

[in] An alpha blend that is described by a DXGK_GDIARG_ALPHABLEND structure.

Command.StretchBlt

[in] A stretch bit-block transfer that is described by a DXGK_GDIARG_STRETCHBLT structure.

Command.TransparentBlt

[in] A transparent bit-block transfer that is described by a DXGK_GDIARG_TRANSPARENTBLT structure.

Command.ClearTypeBlend

[in] A ClearType blend that is described by a DXGK_GDIARG_CLEARTYPEBLEND structure.

Remarks

An array of variable-size DXGK_RENDERKM_COMMAND structures defines a command buffer that is used to control GDI hardware-accelerated rendering.

A display miniport driver should report that it supports command buffer processing for GDI hardware acceleration by setting DXGK_DRIVERCAPS->PresentationCaps.SupportKernelModeCommandBuffer to TRUE.

A display miniport driver should report that it supports GDI hardware acceleration only if the cache-coherent GPU aperture segment exists, and there is no significant performance penalty when the CPU accesses the memory.

Each command varies in length depending on the value of the OpCode member and the number of sub-rectangles in the command.

Requirements

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

See also

DXGK_DRIVERCAPS

DXGK_GDIARG_ALPHABLEND

DXGK_GDIARG_BITBLT

DXGK_GDIARG_CLEARTYPEBLEND

DXGK_GDIARG_COLORFILL

DXGK_GDIARG_STRETCHBLT

DXGK_GDIARG_TRANSPARENTBLT

DXGK_PRESENTATIONCAPS

DXGK_RENDERKM_OPERATION