PFND3DWDDM1_3DDI_UPDATETILEMAPPINGS callback function (d3d10umddi.h)

Article
04/01/2021

Updates mappings of tile locations in tiled resources to memory locations in a tile pool.

Syntax

PFND3DWDDM1_3DDI_UPDATETILEMAPPINGS Pfnd3dwddm13DdiUpdatetilemappings;

void Pfnd3dwddm13DdiUpdatetilemappings(
  D3D10DDI_HDEVICE hDevice,
  D3D10DDI_HRESOURCE hTiledResource,
  UINT NumTiledResourceRegions,
  const D3DWDDM1_3DDI_TILED_RESOURCE_COORDINATE *pTiledResourceRegionStartCoords,
  const D3DWDDM1_3DDI_TILE_REGION_SIZE *pTiledResourceRegionSizes,
  D3D10DDI_HRESOURCE hTilePool,
  UINT NumRanges,
  const UINT *pRangeFlags,
  const UINT *pTilePoolStartOffsets,
  const UINT *pRangeTileCounts,
  UINT Flags
)
{...}

Parameters

hDevice

A handle to the display device (graphics context).

hTiledResource

A handle to the tiled resource.

NumTiledResourceRegions

The number of tiled resource regions.

pTiledResourceRegionStartCoords

An array of D3DWDDM1_3DDI_TILED_RESOURCE_COORDINATE structures that describe the starting coordinates of the tiled resource regions. The NumTiledResourceRegions parameter specifies the number of D3DWDDM1_3DDI_TILED_RESOURCE_COORDINATE structures in the array.

pTiledResourceRegionSizes

An array of D3DWDDM1_3DDI_TILE_REGION_SIZE structures that describe the sizes of the tiled resource regions. The NumTiledResourceRegions parameter specifies the number of D3DWDDM1_3DDI_TILE_REGION_SIZE structures in the array.

hTilePool

A handle to the tile pool.

NumRanges

The number of tile-pool ranges.

pRangeFlags

An array of values that describe each tile-pool range. The NumRanges parameter specifies the number of values in the array. Each value can be a combination of values of type D3DWDDM1_3DDI_TILE_RANGE_FLAG combined by using a bitwise OR operation.

pTilePoolStartOffsets

An array of offsets into the tile pool. These are zero-based tile offsets, counting in tiles (not bytes).

pRangeTileCounts

An array of values that specify the number of tiles in each tile-pool range. The NumRanges parameter specifies the number of values in the array.

Flags

A combination of D3DWDDM1_3DDI_TILE_MAPPING_FLAG values that are combined by using a bitwise OR operation.

Return value

None

Remarks

The driver can use the pfnSetErrorCb callback function to set an error code. The driver can set E_INVALIDARG if a required input parameter does not exist or is NULL.

Requirements

Requirement	Value
Minimum supported client	Windows 8.1,WDDM 1.3
Minimum supported server	Windows Server 2012 R2
Target Platform	Desktop
Header	d3d10umddi.h (include D3d10umddi.h)