Skip to content

Latest commit

 

History

History
95 lines (70 loc) · 1.92 KB

nc-d3d12umddi-pfnd3d12ddi_mapheap.md

File metadata and controls

95 lines (70 loc) · 1.92 KB
Raw
UID title description ms.date keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.lib req.dll req.irql req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library targetos tech.root ms.custom f1_keywords topic_type api_type api_location api_name dev_langs
NC:d3d12umddi.PFND3D12DDI_MAPHEAP
PFND3D12DDI_MAPHEAP (d3d12umddi.h)
A client driver implements PFND3D12DDI_MAPHEAP to map a heap.
08/21/2020
PFND3D12DDI_MAPHEAP callback function
d3d12umddi.h
Windows
display
RS5
PFND3D12DDI_MAPHEAP
d3d12umddi/PFND3D12DDI_MAPHEAP
apiref
UserDefined
d3d12umddi.h
PFND3D12DDI_MAPHEAP
c++

PFND3D12DDI_MAPHEAP callback function

-description

A client driver implements PFND3D12DDI_MAPHEAP to map a heap.

-parameters

-param unnamedParam1 [in]

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

-param unnamedParam2 [in]

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

-param unnamedParam3 [out]

ppData*: A pointer to the mapped heap data.

-returns

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

-prototype

//Declaration

PFND3D12DDI_MAPHEAP Pfnd3d12ddiMapheap;

// Definition

HRESULT Pfnd3d12ddiMapheap
(
    D3D12DDI_HDEVICE hDisplayDevice,
    D3D12DDI_HHEAP hHeap,
    VOID **ppData
)
{...}

PFND3D12DDI_MAPHEAP

-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.

-see-also

PFND3D12DDI_UNMAPHEAP