DXGKCB_ALLOCATEPAGESFORMDL callback function (d3dkmddi.h)

DXGKCB_ALLOCATEPAGESFORMDL allocates physical memory pages for a memory descriptor list (MDL) to be mapped to the IOMMU's logical address space.

Syntax

DXGKCB_ALLOCATEPAGESFORMDL DxgkcbAllocatepagesformdl;

NTSTATUS DxgkcbAllocatepagesformdl(
  [in]     IN_CONST_HANDLE hAdapter,
  [in/out] INOUT_PDXGKARGCB_ALLOCATEPAGESFORMDL pAllocatePagesForMdl
)
{...}

Parameters

[in] hAdapter

A handle to the display adapter.

[in/out] pAllocatePagesForMdl

Pointer to a DXGKARGCB_ALLOCATEPAGESFORMDL structure that contains arguments to allocate pages for MDL.

Return value

Return STATUS_SUCCESS if the operation succeeds. Otherwise, return an appropriate NTSTATUS error code.

Remarks

This callback function is a Windows graphics port driver function equivalent to the MmAllocatePagesForMdl function.

DXGKCB_XXX functions are implemented by Dxgkrnl. To use this callback function, set the appropriate members of DXGKARGCB_ALLOCATEPAGESFORMDL and then call DxgkCbAllocatePagesForMdl via the DXGKRNL_INTERFACE.

All memory accessed by the GPU during paging operations, or mapped via the GpuMmu must be mapped to the IOMMU. Dxgkrnl provides callbacks to the kernel-mode driver to allow the allocation and remapping in one step.

See IOMMU-based GPU isolation for more information.

Requirements

See also

DXGKARGCB_ALLOCATEPAGESFORMDL

DXGKCB_FREEPAGESFROMMDL

DXGKRNL_INTERFACE