DXGKCB_ALLOCATEPAGESFORMDL回调函数 (d3dkmddi.h)

项目
02/23/2024

DXGKCB_ALLOCATEPAGESFORMDL 为内存描述符列表分配物理内存页， (MDL) 映射到 IOMMU 的逻辑地址空间。

语法

DXGKCB_ALLOCATEPAGESFORMDL DxgkcbAllocatepagesformdl;

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

参数

[in] hAdapter

显示适配器的句柄。

[in/out] pAllocatePagesForMdl

指向 DXGKARGCB_ALLOCATEPAGESFORMDL 结构的指针，该结构包含用于为 MDL 分配页面的参数。

返回值

如果操作成功，则返回STATUS_SUCCESS。否则，返回相应的 NTSTATUS 错误代码。

注解

此回调函数是与 MmAllocatePagesForMdl 函数等效的 Windows 图形端口驱动程序函数。

DXGKCB_XXX 函数由 Dxgkrnl 实现。若要使用此回调函数，请设置 DXGKARGCB_ALLOCATEPAGESFORMDL 的相应成员，然后通过 DXGKRNL_INTERFACE调用 DxgkCbAllocatePagesForMdl。

GPU 在分页操作期间访问或通过 GpuMmu 映射的所有内存都必须映射到 IOMMU。 Dxgkrnl 为内核模式驱动程序提供回调，以允许在一个步骤中分配和重新映射。

注意

对 DXGKCB_ALLOCATEPAGESFORMDL 的调用限制为 4GB PAGE_SIZE MDL 限制，Dxgkrnl 始终在对 MmAllocatePagesForMdlEx 函数的内部调用中指定MM_ALLOCATE_FULLY_REQUIRED标志。驱动程序也不应锁定任何内存。 Dxgkrnl 将管理驱动程序的锁定页，重新映射内存后，提供给驱动程序的页面的逻辑地址可能不再与物理地址匹配。

有关详细信息，请参阅基于 IOMMU 的 GPU 隔离。