DXGKDDI_OPENALLOCATIONINFO回调函数 (d3dkmddi.h)

项目
02/23/2024

DxgkDdiOpenAllocation 函数将 DxgkDdiCreateAllocation 函数创建的非特定于设备的分配绑定到特定于指定图形上下文设备的分配。

语法

DXGKDDI_OPENALLOCATIONINFO DxgkddiOpenallocationinfo;

NTSTATUS DxgkddiOpenallocationinfo(
  [in] IN_CONST_HANDLE hDevice,
  [in] IN_CONST_PDXGKARG_OPENALLOCATION pOpenAllocation
)
{...}

参数

[in] hDevice

从中绑定分配的图形上下文设备的句柄。显示微型端口驱动程序的 DxgkDdiCreateDevice 函数以前向 DXGKARG_CREATEDEVICE 结构的 hDevice 成员中的 Microsoft DirectX 图形内核子系统提供了此句柄。

[in] pOpenAllocation

指向包含绑定分配相关信息的 DXGKARG_OPENALLOCATION 结构的指针。

返回值

DxgkDdiOpenAllocation 返回以下值之一：

返回代码	说明
STATUS_SUCCESS	DxgkDdiOpenAllocation 成功将分配绑定到 hDevice 参数指定的图形上下文设备。
STATUS_INVALID_PARAMETER	传递给 DxgkDdiOpenAllocation 的参数包含阻止其完成的错误。
STATUS_NO_MEMORY	DxgkDdiOpenAllocation 无法分配完成该操作所需的内存。
STATUS_GRAPHICS_DRIVER_MISMATCH	显示微型端口驱动程序与启动对 DxgkDdiOpenAllocation (调用的用户模式显示驱动程序不兼容，即向显示微型端口驱动程序) 提供专用数据。

注解

DirectX 图形内核子系统调用显示微型端口驱动程序的 DxgkDdiOpenAllocation 函数，以将 DxgkDdiCreateAllocation 函数创建的非特定于设备的分配绑定到 特定于 hDevice 参数指定的图形上下文设备的分配。显示微型端口驱动程序将分配绑定到设备，以便驱动程序可以跟踪特定于设备的分配数据。

显示微型端口驱动程序可以将分配绑定到任何进程 (在同一图形适配器上) 创建的任何设备，而不仅仅是在创建过程中的设备。

当 DxgkDdiOpenAllocation 返回STATUS_SUCCESS时，驱动程序会将每个分配的 DXGK_OPENALLOCATIONINFO 结构的 hDeviceSpecificAllocation 成员设置为非 NULL 值。每个分配的DXGK_OPENALLOCATIONINFO结构是DXGKARG_OPENALLOCATION结构的 pOpenAllocation 成员指定的数组元素。

仅当创建分配时，驱动程序才能修改在 DXGK_OPENALLOCATIONINFO 结构的 pPrivateDriverData 成员中传递的分配专用驱动程序数据 (当DXGKARG_OPENALLOCATION结构的Flags 成员中的创建位字段标志设置为) 时指示。驱动程序应确定它只能在打开分配时读取分配专用驱动程序数据， (即未) 设置创建位字段标志时。

应使 DxgkDdiOpenAllocation 可分页。