D3DDDI_DEVICECALLBACKS 结构 (d3dumddi.h)

项目
10/14/2023

D3DDDI_DEVICECALLBACKS 结构包含用户模式显示驱动程序可以使用的 Microsoft Direct3D 运行时回调函数。

语法

typedef struct _D3DDDI_DEVICECALLBACKS {
  PFND3DDDI_ALLOCATECB                            pfnAllocateCb;
  PFND3DDDI_DEALLOCATECB                          pfnDeallocateCb;
  PFND3DDDI_SETPRIORITYCB                         pfnSetPriorityCb;
  PFND3DDDI_QUERYRESIDENCYCB                      pfnQueryResidencyCb;
  PFND3DDDI_SETDISPLAYMODECB                      pfnSetDisplayModeCb;
  PFND3DDDI_PRESENTCB                             pfnPresentCb;
  PFND3DDDI_RENDERCB                              pfnRenderCb;
  PFND3DDDI_LOCKCB                                pfnLockCb;
  PFND3DDDI_UNLOCKCB                              pfnUnlockCb;
  PFND3DDDI_ESCAPECB                              pfnEscapeCb;
  PFND3DDDI_CREATEOVERLAYCB                       pfnCreateOverlayCb;
  PFND3DDDI_UPDATEOVERLAYCB                       pfnUpdateOverlayCb;
  PFND3DDDI_FLIPOVERLAYCB                         pfnFlipOverlayCb;
  PFND3DDDI_DESTROYOVERLAYCB                      pfnDestroyOverlayCb;
  PFND3DDDI_CREATECONTEXTCB                       pfnCreateContextCb;
  PFND3DDDI_DESTROYCONTEXTCB                      pfnDestroyContextCb;
  PFND3DDDI_CREATESYNCHRONIZATIONOBJECTCB         pfnCreateSynchronizationObjectCb;
  PFND3DDDI_DESTROYSYNCHRONIZATIONOBJECTCB        pfnDestroySynchronizationObjectCb;
  PFND3DDDI_WAITFORSYNCHRONIZATIONOBJECTCB        pfnWaitForSynchronizationObjectCb;
  PFND3DDDI_SIGNALSYNCHRONIZATIONOBJECTCB         pfnSignalSynchronizationObjectCb;
  PFND3DDDI_SETASYNCCALLBACKSCB                   pfnSetAsyncCallbacksCb;
  PFND3DDDI_SETDISPLAYPRIVATEDRIVERFORMATCB       pfnSetDisplayPrivateDriverFormatCb;
  PFND3DDDI_OFFERALLOCATIONSCB                    pfnOfferAllocationsCb;
  PFND3DDDI_RECLAIMALLOCATIONSCB                  pfnReclaimAllocationsCb;
  PFND3DDDI_CREATESYNCHRONIZATIONOBJECT2CB        pfnCreateSynchronizationObject2Cb;
  PFND3DDDI_WAITFORSYNCHRONIZATIONOBJECT2CB       pfnWaitForSynchronizationObject2Cb;
  PFND3DDDI_SIGNALSYNCHRONIZATIONOBJECT2CB        pfnSignalSynchronizationObject2Cb;
  PFND3DDDI_PRESENTMULTIPLANEOVERLAYCB            pfnPresentMultiPlaneOverlayCb;
  PFND3DDDI_LOGUMDMARKERCB                        pfnLogUMDMarkerCb;
  PFND3DDDI_MAKERESIDENTCB                        pfnMakeResidentCb;
  PFND3DDDI_EVICTCB                               pfnEvictCb;
  PFND3DDDI_WAITFORSYNCHRONIZATIONOBJECTFROMCPUCB pfnWaitForSynchronizationObjectFromCpuCb;
  PFND3DDDI_SIGNALSYNCHRONIZATIONOBJECTFROMCPUCB  pfnSignalSynchronizationObjectFromCpuCb;
  PFND3DDDI_WAITFORSYNCHRONIZATIONOBJECTFROMGPUCB pfnWaitForSynchronizationObjectFromGpuCb;
  PFND3DDDI_SIGNALSYNCHRONIZATIONOBJECTFROMGPUCB  pfnSignalSynchronizationObjectFromGpuCb;
  PFND3DDDI_CREATEPAGINGQUEUECB                   pfnCreatePagingQueueCb;
  PFND3DDDI_DESTROYPAGINGQUEUECB                  pfnDestroyPagingQueueCb;
  PFND3DDDI_LOCK2CB                               pfnLock2Cb;
  PFND3DDDI_UNLOCK2CB                             pfnUnlock2Cb;
  PFND3DDDI_INVALIDATECACHECB                     pfnInvalidateCacheCb;
  PFND3DDDI_RESERVEGPUVIRTUALADDRESSCB            pfnReserveGpuVirtualAddressCb;
  PFND3DDDI_MAPGPUVIRTUALADDRESSCB                pfnMapGpuVirtualAddressCb;
  PFND3DDDI_FREEGPUVIRTUALADDRESSCB               pfnFreeGpuVirtualAddressCb;
  PFND3DDDI_UPDATEGPUVIRTUALADDRESSCB             pfnUpdateGpuVirtualAddressCb;
  PFND3DDDI_CREATECONTEXTVIRTUALCB                pfnCreateContextVirtualCb;
  PFND3DDDI_SUBMITCOMMANDCB                       pfnSubmitCommandCb;
  PFND3DDDI_DEALLOCATE2CB                         pfnDeallocate2Cb;
  PFND3DDDI_SIGNALSYNCHRONIZATIONOBJECTFROMGPU2CB pfnSignalSynchronizationObjectFromGpu2Cb;
  PFND3DDDI_RECLAIMALLOCATIONS2CB                 pfnReclaimAllocations2Cb;
  PFND3DDDI_GETRESOURCEPRESENTPRIVATEDRIVERDATACB pfnGetResourcePresentPrivateDriverDataCb;
  PFND3DDDI_UPDATEALLOCATIONPROPERTYCB            pfnUpdateAllocationPropertyCb;
  PFND3DDDI_OFFERALLOCATIONS2CB                   pfnOfferAllocations2Cb;
  PFND3DDDI_RECLAIMALLOCATIONS3CB                 pfnReclaimAllocations3Cb;
  PFND3DDDI_SYNCTOKENCB                           pfnAcquireResourceCb;
  PFND3DDDI_SYNCTOKENCB                           pfnReleaseResourceCb;
  PFND3DDDI_CREATEHWCONTEXTCB                     pfnCreateHwContextCb;
  PFND3DDDI_DESTROYHWCONTEXTCB                    pfnDestroyHwContextCb;
  PFND3DDDI_CREATEHWQUEUECB                       pfnCreateHwQueueCb;
  PFND3DDDI_DESTROYHWQUEUECB                      pfnDestroyHwQueueCb;
  PFND3DDDI_SUBMITCOMMANDTOHWQUEUECB              pfnSubmitCommandToHwQueueCb;
  PFND3DDDI_SUBMITWAITFORSYNCOBJECTSTOHWQUEUECB   pfnSubmitWaitForSyncObjectsToHwQueueCb;
  PFND3DDDI_SUBMITSIGNALSYNCOBJECTSTOHWQUEUECB    pfnSubmitSignalSyncObjectsToHwQueueCb;
  PFND3DDDI_SUBMITPRESENTBLTTOHWQUEUECB           pfnSubmitPresentBltToHwQueueCb;
  PFND3DDDI_SUBMITPRESENTTOHWQUEUECB              pfnSubmitPresentToHwQueueCb;
  PFND3DDDI_SUBMITHISTORYSEQUENCECB               pfnSubmitHistorySequenceCb;
} D3DDDI_DEVICECALLBACKS;

成员

pfnAllocateCb

指向 pfnAllocateCb 函数的指针，用户模式显示驱动程序使用该函数请求 Direct3D 运行时创建供驱动程序使用的内存分配。

pfnDeallocateCb

指向 pfnDeallocateCb 函数的指针，用户模式显示驱动程序使用该函数请求以前分配的 Direct3D 运行时可用内存。

pfnSetPriorityCb

指向 pfnSetPriorityCb 函数的指针，用户模式显示驱动程序使用该函数来设置资源或分配列表的优先级。

pfnQueryResidencyCb

指向 pfnQueryResidencyCb 函数的指针，用户模式显示驱动程序使用该函数来查询资源或分配列表的驻留状态。

pfnSetDisplayModeCb

指向 pfnSetDisplayModeCb 函数的指针，用户模式显示驱动程序使用该函数来设置显示分配。

pfnPresentCb

指向 pfnPresentCb 函数的指针，用户模式显示驱动程序使用该函数将 present 命令提交到显示微型端口驱动程序。

pfnRenderCb

指向 pfnRenderCb 函数的指针，用户模式显示驱动程序使用该函数将命令缓冲区提交到显示微型端口驱动程序。

pfnLockCb

指向 pfnLockCb 函数的指针，用户模式显示驱动程序使用该函数从显示微型端口驱动程序请求锁。用户模式显示驱动程序无法完全处理此锁。

pfnUnlockCb

指向 pfnUnlockCb 函数的指针，用户模式显示驱动程序使用该函数调用显示微型端口驱动程序进行解锁。用户模式显示驱动程序无法完全处理此解锁。

pfnEscapeCb

指向 pfnEscapeCb 函数的指针，用户模式显示驱动程序使用该函数与显示微型端口驱动程序共享信息。

pfnCreateOverlayCb

指向 pfnCreateOverlayCb 函数的指针，用户模式显示驱动程序使用该函数创建和显示内核模式覆盖对象。

pfnUpdateOverlayCb

指向 pfnUpdateOverlayCb 函数的指针，用户模式显示驱动程序使用该函数修改内核模式覆盖对象。

pfnFlipOverlayCb

指向 pfnFlipOverlayCb 函数的指针，用户模式显示驱动程序使用该函数更改覆盖显示的分配。

pfnDestroyOverlayCb

指向 pfnDestroyOverlayCb 函数的指针，用户模式显示驱动程序使用该函数销毁内核模式覆盖对象并阻止显示覆盖。

pfnCreateContextCb

指向 pfnCreateContextCb 函数的指针，用户模式显示驱动程序使用该函数创建要向其提交请求的上下文。

pfnDestroyContextCb

指向 pfnDestroyContextCb 函数的指针，用户模式显示驱动程序使用该函数销毁 pfnCreateContextCb 创建的上下文。

pfnCreateSynchronizationObjectCb

指向 pfnCreateSynchronizationObjectCb 函数的指针，用户模式显示驱动程序使用该函数创建同步对象。

pfnDestroySynchronizationObjectCb

指向 pfnDestroySynchronizationObjectCb 函数的指针，用户模式显示驱动程序使用该函数销毁 pfnCreateSynchronizationObjectCb 创建的同步对象。

pfnWaitForSynchronizationObjectCb

指向 pfnWaitForSynchronizationObjectCb 函数的指针，用户模式显示驱动程序使用该函数来等待同步事件发生，然后使用返回。

pfnSignalSynchronizationObjectCb

指向 pfnSignalSynchronizationObjectCb 函数的指针，用户模式显示驱动程序使用该函数来指示上下文不再拥有同步事件。

pfnSetAsyncCallbacksCb

指向 pfnSetAsyncCallbacksCb 函数的指针，用户模式显示驱动程序使用该指针通知 Direct3D 运行时运行时是启动还是停止接收来自工作线程的运行时回调函数的调用。

只有 DirectX 9 和 Direct 9L 版本的运行时支持 pfnSetAsyncCallbacksCb 函数。当运行时调用用户模式显示驱动程序的 CreateDevice (D3D10) 函数来创建呈现设备时，DirectX 10 及更高版本的运行时将 pfnSetAsyncCallbacksCb 成员设置为 NULL。

pfnSetDisplayPrivateDriverFormatCb

指向 pfnSetDisplayPrivateDriverFormatCb 函数的指针，用户模式显示驱动程序使用该函数更改共享主图面的格式。

pfnOfferAllocationsCb

指向 pfnOfferAllocationsCb 函数的指针，WDDM 1.2 及更高版本的用户模式显示驱动程序调用以提供视频内存分配以供重复使用。

支持从Windows 8开始。

pfnReclaimAllocationsCb

指向 pfnReclaimAllocationsCb 函数的指针，WDDM 1.2 及更高版本的用户模式显示驱动程序调用该函数以回收以前提供以供重复使用的视频内存分配的访问权限。

支持从Windows 8开始。

pfnCreateSynchronizationObject2Cb

指向 pfnCreateSynchronizationObject2Cb 函数的指针，WDDM 1.2 及更高版本的用户模式显示驱动程序使用该函数创建 GPU 同步对象。

支持从Windows 8开始。

pfnWaitForSynchronizationObject2Cb