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 |