PFND3DDDI_TEXBLT callback function (d3dumddi.h)

Article
04/01/2021

The TexBlt function performs a bit-block transfer (bitblt) operation from a source texture to a destination texture, including all of the sublevels of the source texture.

Syntax

PFND3DDDI_TEXBLT Pfnd3dddiTexblt;

HRESULT Pfnd3dddiTexblt(
  HANDLE hDevice,
  const D3DDDIARG_TEXBLT *unnamedParam2
)
{...}

Parameters

hDevice

A handle to the display device (graphics context).

unnamedParam2

pData [in]

A pointer to a D3DDDIARG_TEXBLT structure that defines the parameters for the texture bitblt operation.

Return value

TexBlt returns S_OK or an appropriate error result if the texture bitblt operation is not successfully performed.

Remarks

The Microsoft Direct3D runtime calls the user-mode display driver's TexBlt function to inform the driver to perform a bitblt operation from a source texture to a destination texture. A texture can also be a cubic environment map. The driver should copy the rectangle that is specified by the SrcRect member of the D3DDDIARG_TEXBLT structure in the source texture to the location that is specified by the DstPoint member of D3DDDIARG_TEXBLT in the destination texture. The destination and source textures are identified by the hDstResource and hSrcResource handles of D3DDDIARG_TEXBLT, respectively.

For MIP-mapped textures, the driver must also copy all of the MIP-map sublevels that are present in the source texture. The source and destination textures might possibly contain different numbers of MIP-map levels. In this situation, the driver should copy the common levels. For example, if a 256x256 source texture has eight MIP-map levels, and if the destination is a 64x64 texture with six levels, the driver should copy the six corresponding levels from the source. Note that the dimensions of the top MIP level of the destination texture is always less than or equal to the dimensions of the top MIP level of the source texture.

The source and destination handles always refer to the top-level surfaces and never to any MIP-map sublevel.

To copy an arbitrary level of a MIP-map texture, the runtime calls the driver's Blt function instead.

The pixel formats of the source and destination textures are identical and, in general, the specified bitblt operation is safe to perform.

Requirements

Requirement	Value
Minimum supported client	Available in Windows Vista and later versions of the Windows operating systems.
Target Platform	Desktop
Header	d3dumddi.h (include D3dumddi.h)