DXGKDDI_SUBMITCOMMAND回调函数 (d3dkmddi.h)
DxgkDdiSubmitCommand 函数将直接内存访问(DMA)缓冲区提交到硬件命令执行单元。
语法
DXGKDDI_SUBMITCOMMAND DxgkddiSubmitcommand;
NTSTATUS DxgkddiSubmitcommand(
[in] IN_CONST_HANDLE hAdapter,
[in] IN_CONST_PDXGKARG_SUBMITCOMMAND pSubmitCommand
)
{...}
参数
[in] hAdapter
与显示适配器关联的上下文块的句柄。 显示微型端口驱动程序以前向 MiniportDeviceContext 中的 Microsoft DirectX 图形内核子系统提供了此句柄,DxgkDdiAddDevice 函数的输出参数。
[in] pSubmitCommand
指向 DXGKARG_SUBMITCOMMAND 结构的指针,该结构描述显示微型端口驱动程序提交到硬件命令执行单元的 DMA 缓冲区。
返回值
DxgkDdiSubmitCommand 成功完成后返回 STATUS_SUCCESS。 如果驱动程序改为返回错误代码,则作系统会导致系统 bug 检查发生。 请参阅“备注”。
言论
由于分页作被视为系统作,因此它们不与特定的应用程序上下文或图形上下文相关联。 因此,提交用于分页作时,会调用 DxgkDdiSubmitCommand 函数,并在 hDevice 成员中指定的hDeviceDXGKARG_SUBMITCOMMAND 成员 pSubmitCommand 参数指向该函数。
但是,如果特定硬件和驱动程序的体系结构必须在内部具有设备,驱动程序必须在适配器初始化期间内部创建设备,并且必须将设备作为系统默认设备在内部保留,以便在分页作中使用。
驱动程序可以将 SubmissionFenceId DXGKARG_SUBMITCOMMAND 成员中提供的值写入环形缓冲区中的围栏命令中。 有关围栏命令的详细信息,请参阅 提供围栏标识符。
如果驱动程序返回错误代码,DirectX 图形内核子系统会导致系统 bug 检查发生。 在故障转储文件中,错误消息 BugCheck 0x119指出,该消息将具有以下四个参数。
- 0x2(标识错误的原因)
- 从失败的驱动程序调用返回的 NTSTATUS 错误代码
- 指向 DXGKARG_SUBMITCOMMAND 结构的指针
- 指向内部计划程序数据结构的指针
应将 DxgkDdiSubmitCommand 设置为不可分页,因为它在 IRQL = DISPATCH_LEVEL 上运行。
要求
要求 | 价值 |
---|---|
最低支持的客户端 | Windows Vista |
目标平台 | 桌面 |
标头 | d3dkmddi.h |
IRQL | DISPATCH_LEVEL |