_D3DDDI_BLTFLAGS structure

The D3DDDI_BLTFLAGS structure identifies the type of bit-block transfer (bitblt) to perform.

Syntax

typedef struct _D3DDDI_BLTFLAGS {
  union {
    struct {
      UINT Point : 1;
      UINT Linear : 1;
      UINT SrcColorKey : 1;
      UINT DstColorKey : 1;
      UINT MirrorLeftRight : 1;
      UINT MirrorUpDown : 1;
      UINT LinearToSrgb : 1;
      UINT Rotate : 1;
      UINT BeginPresentToDwm : 1;
      UINT ContinuePresentToDwm : 1;
      UINT EndPresentToDwm : 1;
      UINT Reserved : 21;
      UINT Discard : 1;
      UINT NoOverwrite : 1;
      UINT Tileable : 1;
      UINT Reserved : 18;
    };
    UINT Value;
  };
} D3DDDI_BLTFLAGS;

Members

Remarks

The BeginPresentToDwm, ContinuePresentToDwm, and EndPresentToDwm bit-field flags inform the user-mode display driver about the time when the Direct3D runtime performs parts of a DWM present operation. Because DWM present operations can occur in multiple steps, the Direct3D runtime uses these flags to mark the steps in a sequence of bitblts. For example:

  • If the present operation consists of one bitblt, the bitblt is marked as follows:
    • BeginPresentToDwm = TRUE;
    • ContinuePresentToDwm = FALSE;
    • EndPresentToDwm = TRUE;
  • If the present operation consists of two bitblts, the bitblts are marked as shown in two sequential bitblt operations:
    1. First bitblt:
      • BeginPresentToDwm = TRUE;
      • ContinuePresentToDwm = FALSE;
      • EndPresentToDwm = FALSE;
    2. Second bitblt:
      • BeginPresentToDwm = FALSE;
      • ContinuePresentToDwm = FALSE;
      • EndPresentToDwm = TRUE;
  • If the present operation consists of three or more bitblts, the bitblts are marked as shown in the following sequential bitblt operations:
    1. First bitblt:
      • BeginPresentToDwm = TRUE;
      • ContinuePresentToDwm = FALSE;
      • EndPresentToDwm = FALSE;
    2. Second and successive bitblts, not including the final bitblt:
      • BeginPresentToDwm = FALSE;
      • ContinuePresentToDwm = TRUE;
      • EndPresentToDwm = FALSE;
    3. Final bitblt:
      • BeginPresentToDwm = FALSE;
      • ContinuePresentToDwm = FALSE;
      • EndPresentToDwm = TRUE;

Requirements

   
Windows version Available starting with Windows Vista. Available starting with Windows Vista.
Header d3dumddi.h (include D3dumddi.h)

See Also

D3DDDIARG_BLT

Flush