User-Mode 显示驱动程序调用的 Direct3D 运行时函数

项目
06/15/2023

本主题列出了 Microsoft Direct3D 运行时提供给用户模式显示驱动程序的函数。其中包括访问函数的 Direct3D 运行时内核服务以及 Direct3D 运行时版本 10 和 11 函数。这些函数是操作系统通过 Direct3D 运行时实现的用户模式 Direct3D 显示驱动程序接口的一部分。

Direct3D 运行时 Kernel-Services 访问函数

Microsoft Direct3D 版本 9 运行时在调用用户模式显示驱动程序的 OpenAdapter 函数时，通过 D3DDDI_ADAPTERCALLBACKS 结构的成员提供指向适配器特定回调函数的指针。运行时提供指针，用于在调用用户模式显示驱动程序的 CreateDevice 函数时，通过 D3DDDI_DEVICECALLBACKS 结构的成员显示特定于设备的回调函数。

Microsoft Direct3D 版本 10 或更高版本运行时在调用用户模式显示驱动程序的 OpenAdapter10 或 OpenAdapter10_2 函数时，通过 D3DDDI_ADAPTERCALLBACKS 结构的成员提供指向适配器特定的回调函数的指针。运行时提供指针，以在调用用户模式显示驱动程序的 CreateDevice (D3D10) 函数时，通过 D3DDDI_DEVICECALLBACKS 结构的成员显示特定于设备的回调函数。

Direct3D 参数结构

以下结构由访问函数的 Direct3D 运行时内核服务使用。用户模式显示驱动程序在运行时函数的参数中传递指向这些结构的指针。

D3DDDI_UPDATEALLOCPROPERTY
D3DDDICB_ALLOCATE
D3DDDICB_CREATECONTEXT
D3DDDICB_CREATECONTEXTVIRTUAL
D3DDDICB_CREATEHWCONTEXT
D3DDDICB_CREATEHWQUEUE
D3DDDICB_CREATEOVERLAY
D3DDDICB_CREATEPAGINGQUEUE
D3DDDICB_CREATESYNCHRONIZATIONOBJECT2
D3DDDICB_CREATESYNCHRONIZATIONOBJECT
D3DDDICB_DESTROYHWCONTEXT
D3DDDICB_DESTROYHWQUEUE
D3DDDICB_DEALLOCATE
D3DDDICB_DEALLOCATE2
D3DDDICB_DESTROYCONTEXT
D3DDDICB_DESTROYOVERLAY
D3DDDICB_DESTROYSYNCHRONIZATIONOBJECT
D3DDDICB_ESCAPE
D3DDDICB_EVICT
D3DDDICB_FLIPOVERLAY
D3DDDICB_GETMULTISAMPLEMETHODLIST
D3DDDICB_LOCK
D3DDDICB_LOCK2FLAGS
D3DDDICB_OFFERALLOCATIONS
D3DDDICB_PRESENT
D3DDDICB_QUERYADAPTERINFO
D3DDDICB_QUERYRESIDENCY
D3DDDICB_RECLAIMALLOCATIONS
D3DDDICB_RECLAIMALLOCATIONS2
D3DDDICB_RENDER
D3DDDICB_SETDISPLAYMODE
D3DDDICB_SETDISPLAYPRIVATEDRIVERFORMAT
D3DDDICB_SETPRIORITY
D3DDDICB_SIGNALSYNCHRONIZATIONOBJECT
D3DDDICB_SIGNALSYNCHRONIZATIONOBJECT2
D3DDDICB_SIGNALSYNCHRONIZATIONOBJECTFROMCPU
D3DDDICB_SIGNALSYNCHRONIZATIONOBJECTFROMGPU
D3DDDICB_SIGNALSYNCHRONIZATIONOBJECTFROMGPU2
D3DDDICB_SUBMITCOMMAND
D3DDDICB_SUBMITCOMMANDFLAGS
D3DDDICB_SUBMITCOMMANDTOHWQUEUE
D3DDDICB_SUBMITSIGNALSYNCOBJECTSTOHWQUEUE
D3DDDICB_SUBMITWAITFORSYNCOBJECTSTOHWQUEUE
D3DDDICB_UNLOCK
D3DDDICB_UNLOCK2
D3DDDICB_UPDATEGPUVIRTUALADDRESS
D3DDDICB_UPDATEOVERLAY
D3DDDICB_WAITFORSYNCHRONIZATIONOBJECT
D3DDDICB_WAITFORSYNCHRONIZATIONOBJECT2
D3DDDICB_WAITFORSYNCHRONIZATIONOBJECTFROMCPU
D3DDDICB_WAITFORSYNCHRONIZATIONOBJECTFROMGPU

Direct3D 运行时版本 10 及更高版本核心回调函数

本部分介绍 Microsoft Direct3D 10 及更高版本运行时提供给用户模式显示驱动程序的核心回调函数。运行时在调用用户模式显示驱动程序的 CreateDevice (D3D10) 函数时，通过 D3D10DDI_CORELAYER_DEVICECALLBACKS 结构的成员提供指向核心回调函数的指针。

Direct3D 运行时版本 10 控制回调函数

下面是 Microsoft Direct3D 10 及更高版本运行时通过D3D10DDI_CORELAYER_DEVICECALLBACKS结构提供给用户模式显示驱动程序的控制回调函数列表。

Direct3D 运行时版本 10 State-Refresh 回调函数

下面是 Microsoft Direct3D 10 运行时通过D3D10DDI_CORELAYER_DEVICECALLBACKS结构提供给用户模式显示驱动程序的状态刷新回调函数的列表。

由于 Direct3D 10 运行时缓存应用程序的当前绑定状态对象，因此运行时还会缓存当前绑定的状态对象，以较低的开销为用户模式显示驱动程序。对于用户模式显示驱动程序对状态刷新回调函数进行的每个调用，Direct3D 10 运行时会在同一执行线程中对驱动程序状态函数进行相应的调用，然后再返回到驱动程序中的调用代码。为了提高性能，状态刷新回调函数不执行任何参数验证。

当你尝试开发无状态驱动程序或构建命令缓冲区前备数据时，状态刷新回调函数非常有用。状态刷新回调函数还允许用户模式显示驱动程序受益于 Direct3D 10 运行时维护的高水印。高水印表示最大的槽索引，可能为非 NULL;因此，高水印可改善跨此类槽的遍历。

Direct3D 运行时版本 10 Kernel-Services 访问函数

本部分列出了 DirectX 图形基础结构 (Microsoft Direct3D 10 运行时的 DXGI) 组件提供给用户模式显示驱动程序的内核服务。 DXGI 在调用用户模式显示驱动程序的 CreateDevice (D3D10 ) 函数时，提供通过 DXGI_DDI_BASE_CALLBACKS 结构的成员访问函数的内核服务的指针。

PFNDDXGIDDI_PRESENTCB
PFNDDXGIDDI_PRESENT_MULTIPLANE_OVERLAYCB
PFNDDXGIDDI_PRESENT_MULTIPLANE_OVERLAY1C
PFNDDXGIDDI_SUBMITPRESENTBLTTOHWQUEUECB
PFNDDXGIDDI_SUBMITPRESENTTOHWQUEUECB

Direct3D 运行时版本 11 函数

本部分介绍 Microsoft Direct3D 11 及更高版本运行时提供给用户模式显示驱动程序的核心回调函数。运行时在调用用户模式显示驱动程序的 CreateDevice (D3D10) 函数时，通过 D3D11DDI_CORELAYER_DEVICECALLBACKS 结构的成员提供指向核心回调函数的指针。

Direct3D 运行时版本 11 控制回调函数

本部分列出了 Microsoft Direct3D 11 及更高版本运行时提供给用户模式显示驱动程序的其他控件回调函数。

PFND3D11DDI_PERFORM_AMORTIZED_PROCESSING_CB

Direct3D 运行时版本 11 State-Refresh 回调函数

本部分列出了 Microsoft Direct3D 版本 11 及更高版本运行时提供给用户模式显示驱动程序的其他状态刷新回调函数。

由于 Direct3D 11 运行时缓存应用程序的当前绑定状态对象，因此运行时还会缓存当前绑定的状态对象，以便用户模式显示驱动程序具有较低的开销。对于用户模式显示驱动程序对状态刷新回调函数进行的每个调用，Direct3D 11 运行时在同一执行线程中对驱动程序状态函数进行相应的调用，然后再返回到驱动程序中的调用代码。为了提高性能，状态刷新回调函数不执行任何参数验证。

当你尝试开发无状态驱动程序或构建命令缓冲区前言数据时，状态刷新回调函数非常有用。状态刷新回调函数还允许用户模式显示驱动程序受益于 Direct3D 11 运行时维护的高水印。高水印表示最大的槽索引，可能为非 NULL;因此，高水印可改善跨此类槽的遍历。