DXGKDDI_GETSTANDARDALLOCATIONDRIVERDATA回调函数 (d3dkmddi.h)

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

语法

DXGKDDI_GETSTANDARDALLOCATIONDRIVERDATA DxgkddiGetstandardallocationdriverdata;

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

参数

[in] hAdapter

与显示适配器关联的上下文块的句柄。 内核模式显示驱动程序(KMD)以前在其 DxgkDdiAddDevice 函数中提供了此句柄来 Dxgkrnl

[in/out] pGetStandardAllocationDriverData

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

返回值

DxgkDdiGetStandardAllocationDriverData 返回以下值之一:

返回代码 描述
STATUS_SUCCESS DxgkDdiGetStandardAllocationDriverData 成功返回了标准分配类型的说明。
STATUS_NO_MEMORY DxgkDdiGetStandardAllocationDriverData 无法分配完成所需的内存。

言论

标准分配类型 是必须在内核模式下创建的分配,而无需与用户模式显示驱动程序通信。

Dxgkrnl 调用内核模式驱动程序 DxgkDdiGetStandardAllocationDriverData 函数来生成 pGetStandardAllocationDriverData 参数指定的标准分配类型的说明。 KMD 返回 pAllocationPrivateDriverDatapResourcePrivateDriverDatapGetStandardAllocationDriverData 参数指向的 DXGKARG_GETSTANDARDALLOCATIONDRIVERDATA 结构成员中的分配类型的说明。 Dxgkrnl 随后将说明传递给 DxgkDdiCreateAllocation 函数,以实际创建分配。

从 Windows 7 开始,如果 KMD 处理对 DxgkDdiGetStandardAllocationDriverData 函数的调用来创建 GDI 硬件加速的分配,驱动程序应设置 CPU 可见分配的分配的间距,**pGetStandardAllocationDriverData->pCreateGdiSurfaceData->**Pitch

DxgkDdiGetStandardAllocationDriverData 进行分页。

要求

要求 价值
最低支持的客户端 Windows Vista
目标平台 桌面
标头 d3dkmddi.h
IRQL PASSIVE_LEVEL

另请参阅

DXGKARG_GETSTANDARDALLOCATIONDRIVERDATA

DxgkDdiAddDevice

DxgkDdiCreateAllocation