Edit

Share via

PFND3D12DDI_MAPHEAP callback function (d3d12umddi.h)

  • Article

A client driver implements PFND3D12DDI_MAPHEAP to map a heap.

Syntax

PFND3D12DDI_MAPHEAP Pfnd3d12ddiMapheap;

HRESULT Pfnd3d12ddiMapheap(
  [in]  D3D12DDI_HDEVICE unnamedParam1,
  [in]  D3D12DDI_HHEAP unnamedParam2,
  [out] VOID **unnamedParam3
)
{...}

Parameters

[in] unnamedParam1

hDisplayDevice: Handle to the display device (graphics context).

[in] unnamedParam2

hHeap: Handle to a display device-managed heap that needs to be mapped.

[out] unnamedParam3

ppData*: A pointer to the mapped heap data.

Return value

PFND3D12DDI_MAPHEAP returns S_OK on success. It should return an appropriate HRESULT error code on failure.

Remarks

Heap data is typically accessible to the GPU only. PFND3D12DDI_MAPHEAP makes the heap data accessible to the CPU. The driver should map the heap data and return a CPU-accessible pointer in ppData.

Requirements

Requirement Value
Header d3d12umddi.h

See also

PFND3D12DDI_UNMAPHEAP