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 返回 pAllocationPrivateDriverData 和 pResourcePrivateDriverDatapGetStandardAllocationDriverData 参数指向的 DXGKARG_GETSTANDARDALLOCATIONDRIVERDATA 结构成员中的分配类型的说明。 Dxgkrnl 随后将说明传递给 DxgkDdiCreateAllocation 函数,以实际创建分配。
从 Windows 7 开始,如果 KMD 处理对 DxgkDdiGetStandardAllocationDriverData 函数的调用来创建 GDI 硬件加速的分配,驱动程序应设置 CPU 可见分配的分配的间距,**pGetStandardAllocationDriverData->pCreateGdiSurfaceData->**Pitch。
应 DxgkDdiGetStandardAllocationDriverData 进行分页。
要求
要求 | 价值 |
---|---|
最低支持的客户端 | Windows Vista |
目标平台 | 桌面 |
标头 | d3dkmddi.h |
IRQL | PASSIVE_LEVEL |