DXGKDDI_GETSTANDARDALLOCATIONDRIVERDATA回调函数 (d3dkmddi.h)

项目
02/23/2024

DxgkDdiGetStandardAllocationDriverData 函数返回标准分配类型的说明。

语法

DXGKDDI_GETSTANDARDALLOCATIONDRIVERDATA DxgkddiGetstandardallocationdriverdata;

NTSTATUS DxgkddiGetstandardallocationdriverdata(
  [in]     IN_CONST_HANDLE hAdapter,
  [in/out] INOUT_PDXGKARG_GETSTANDARDALLOCATIONDRIVERDATA pGetStandardAllocationDriverData
)
{...}

参数

[in] hAdapter

与显示适配器关联的上下文块的句柄。显示微型端口驱动程序之前在 DxgkDdiAddDevice 函数的 MiniportDeviceContext 输出参数中向 Microsoft DirectX 图形内核子系统提供了此句柄。

[in/out] pGetStandardAllocationDriverData

指向描述标准分配的 DXGKARG_GETSTANDARDALLOCATIONDRIVERDATA 结构的指针。

返回值

DxgkDdiGetStandardAllocationDriverData 返回以下值之一：

返回代码	说明
STATUS_SUCCESS	DxgkDdiGetStandardAllocationDriverData 已成功返回标准分配类型的说明。
STATUS_NO_MEMORY	DxgkDdiGetStandardAllocationDriverData 无法分配完成该操作所需的内存。

注解

标准分配类型 是在内核模式下创建的分配，无需与用户模式显示驱动程序通信。 DirectX 图形内核子系统调用 DxgkDdiGetStandardAllocationDriverData 函数，以生成 pGetStandardAllocationDriverData 参数指定的标准分配类型的说明。显示微型端口驱动程序返回 pGetStandardAllocationDriverData 参数指向的 DXGKARG_GETSTANDARDALLOCATIONDRIVERDATA 结构的 pAllocationPrivateDriverData 和 pResourcePrivateDriverData 成员中的分配类型的说明。 DirectX 图形内核子系统随后将说明传递给 DxgkDdiCreateAllocation 函数，以实际创建分配。

从 Windows 7 开始，如果显示微型端口驱动程序处理对 DxgkDdiGetStandardAllocationDriverData 函数的调用以创建 GDI 硬件加速的分配，则驱动程序应设置 CPU 可见分配的分配间距 pGetStandardAllocationDriverData-pCreateGdiSurfaceData-Pitch>>。

DxgkDdiGetStandardAllocationDriverData 应可分页。