DXGKCB_OPENPHYSICALMEMORYOBJECT回调函数 (d3dkmddi.h)

项目
02/23/2024

内核模式显示微型端口驱动程序调用 DXGKCB_OPENPHYSICALMEMORYOBJECT 打开物理内存对象并将其与适配器相关联。

语法

DXGKCB_OPENPHYSICALMEMORYOBJECT DxgkcbOpenphysicalmemoryobject;

NTSTATUS DxgkcbOpenphysicalmemoryobject(
  [in/out] IN_OUT_PDXGKARGCB_OPEN_PHYSICAL_MEMORY_OBJECT pArgs
)
{...}

参数

[in/out] pArgs

指向 DXGKARGCB_OPEN_PHYSICAL_MEMORY_OBJECT 结构的指针，该结构包含有关要打开的物理内存对象的信息。

返回值

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

注解

若要从物理内存对象创建地址描述符列表 (ADL) ，必须先将其与适配器相关联。这通常在通过在调用 DXGKCB_CREATEPHYSICALMEMORYOBJECT 中指定 hAdapter 参数来创建物理内存对象时完成。但是，在某些情况下，适配器句柄在 (分配内存时不可用，例如，在启动过程) 早期。在这种情况下，驱动程序必须调用 DXGKCB_OPENPHYSICALMEMORYOBJECT ，以在调用 DXGKCB_ALLOCATEADL 之前将物理内存对象与适配器相关联。

有关详细信息，请参阅 IOMMU DMA 重新映射。

DXGKCB_XXX 函数由 Dxgkrnl 实现。若要使用此回调函数，请设置 DXGKARGCB_OPEN_PHYSICAL_MEMORY_OBJECT 的适当成员，然后通过 DXGKRNL_INTERFACE调用 DxgkCbOpenPhysicalMemoryObject。