DXGKDDI_VALIDATESUBMITCOMMAND回调函数 (d3dkmddi.h)

  • 项目

内核模式显示微型端口 (KMD 的) DXGKDDI_VALIDATESUBMITCOMMAND 函数验证用户模式驱动程序 (UMD) 在调用 D3DKMTSubmitCommand 或 D3DKMTSubmitCommandToHwQueue 时传递的专用驱动程序数据。

语法

DXGKDDI_VALIDATESUBMITCOMMAND DxgkddiValidatesubmitcommand;

NTSTATUS DxgkddiValidatesubmitcommand(
  IN_CONST_HANDLE hContext,
  INOUT_PDXGKARG_VALIDATESUBMITCOMMAND pArgs
)
{...}

参数

hContext

[in]微型端口设备上下文的句柄，KMD 从 DxgkDdiAddDevice 返回。

pArgs

[in/out]指向包含验证提交命令所需信息的 DXGKARG_VALIDATESUBMITCOMMAND 结构的指针。

返回值

DXGKDDI_VALIDATESUBMITCOMMAND 返回 NTSTATUS 值，如下所示之一：

  • STATUS_SUCCESS
  • STATUS_INVALID_USER_BUFFER

注解

当 KMD 实现此回调时，KMD 始终验证传入的调用中的专用数据：

仅当 D3DKMTSubmitCommand 中的专用驱动程序大小 (DmaBufferPrivateDataSize) 不是零时，才会调用此回调。

它按 D3DKMTSubmitCommand 或 D3DKMTSubmitCommandToHwQueue 调用一次。

KMD 不应假定在调用 D3DKMTSubmitCommand 的进程上下文中调用此回调。 因此，UMD 不应在其专用数据中传递任何用户模式指针或句柄。

在将命令提交到 GPU 计划程序软件队列以供执行之前调用此回调。

要求

要求 值
最低受支持的客户端 Windows 10 版本 1809
标头 d3dkmddi.h
IRQL PASSIVE_LEVEL

另请参阅

DXGKARG_VALIDATESUBMITCOMMAND