Edit

D3DHAL_DP2SURFACEBLT structure (d3dhal.h)

  • Article

DirectX 9.0 and later versions only.

D3DHAL_DP2SURFACEBLT is used for two dimensional system memory to video memory surface blts when D3dDrawPrimitives2 responds to the D3DDP2OP_SURFACEBLT command token.

Syntax

typedef struct _D3DHAL_DP2SURFACEBLT {
  DWORD dwSource;
  RECTL rSource;
  DWORD dwSourceMipLevel;
  DWORD dwDest;
  RECTL rDest;
  DWORD dwDestMipLevel;
  DWORD Flags;
} D3DHAL_DP2SURFACEBLT;

Members

dwSource

Specifies the handle to the source surface.

rSource

Specifies a RECTL structure that specifies the upper left and lower right points of a rectangle on the source surface. These points define the area of the source blit data and its position on the source surface.

dwSourceMipLevel

Specifies the sublevel of a MIP-map texture that is the source of the blt.

dwDest

Specifies the handle to the destination surface.

rDest

Specifies a RECTL structure that specifies the upper left and lower right points of a rectangle on the destination surface. These points define the area in which the blit should occur and its position on the destination surface.

dwDestMipLevel

Specifies the sublevel of a MIP-map texture that is the destination for the blt.

Flags

Unused

Remarks

The D3DDP2OP_SURFACEBLT operation code is identical to the D3DDP2OP_BLT operation code except that D3DDP2OP_SURFACEBLT is only used to copy system memory to video memory and is never used for stretch blts or color conversion. Because D3DDP2OP_SURFACEBLT is not used for stretch blts, no flags are currently defined.

The dwSource or dwDest member specifies the kernel handle to the top-level surface and the dwSourceMipLevel or dwDestMiplevel member specifies the sublevel for the MIP-map chain where the blt occurs.

Requirements

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

See also

D3DDP2OP_BLT

D3DDP2OP_SURFACEBLT

D3DHAL_DP2COMMAND

D3dDrawPrimitives2