структура 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 , которую драйвер отображения пользовательского режима использует для отправки текущей команды в драйвер мини-порта дисплея.

pfnRenderCb

Указатель на функцию pfnRenderCb , которую драйвер отображения пользовательского режима использует для отправки буфера команд в драйвер мини-порта дисплея.

pfnLockCb

Указатель на функцию pfnLockCb , которую драйвер дисплея пользовательского режима использует для запроса блокировки от драйвера мини-порта дисплея. Эта блокировка не может быть полностью обработана драйвером отображения пользовательского режима.

pfnUnlockCb

Указатель на функцию pfnUnlockCb , которую драйвер дисплея пользовательского режима использует для вызова драйвера минипорта дисплея для разблокировки. Эта разблокировка не может быть полностью обработана драйвером отображения пользовательского режима.

pfnEscapeCb

Указатель на функцию pfnEscapeCb , которую драйвер дисплея пользовательского режима использует для обмена информацией с драйвером мини-порта дисплея.

pfnCreateOverlayCb

Указатель на функцию pfnCreateOverlayCb , которую драйвер отображения пользовательского режима использует для создания и отображения объекта наложения в режиме ядра.

pfnUpdateOverlayCb

Указатель на функцию pfnUpdateOverlayCb , которую драйвер отображения пользовательского режима использует для изменения объекта наложения в режиме ядра.

pfnFlipOverlayCb

Указатель на функцию pfnFlipOverlayCb , которую драйвер отображения пользовательского режима использует для изменения выделения, отображаемого наложением.

pfnDestroyOverlayCb

Указатель на функцию pfnDeмешательOverlayCb , которую драйвер отображения пользовательского режима использует для уничтожения объекта наложения в режиме ядра и остановки отображения наложения.

pfnCreateContextCb

Указатель на функцию pfnCreateContextCb , которую драйвер отображения пользовательского режима использует для создания контекста для отправки запросов.

pfnDestroyContextCb

Указатель на функцию pfnDetextContextCb , которую драйвер отображения пользовательского режима использует для уничтожения контекста, созданного pfnCreateContextCb .

pfnCreateSynchronizationObjectCb

Указатель на функцию pfnCreateSynchronizationObjectCb , которую драйвер отображения пользовательского режима использует для создания объекта синхронизации.

pfnDestroySynchronizationObjectCb

Указатель на функцию pfnDesynchronizationObjectCb , которую драйвер отображения пользовательского режима использует для уничтожения объекта синхронизации, созданного pfnCreateSynchronizationObjectCb .

pfnWaitForSynchronizationObjectCb

Указатель на функцию pfnWaitForSynchronizationObjectCb , которую драйвер отображения пользовательского режима использует для ожидания событий синхронизации, а затем использует для возврата.

pfnSignalSynchronizationObjectCb

Указатель на функцию pfnSignalSynchronizationObjectCb , которую драйвер отображения пользовательского режима использует для сигнализации о том, что события синхронизации больше не принадлежат контексту.

pfnSetAsyncCallbacksCb

Указатель на функцию pfnSetAsyncCallbacksCb , которую драйвер отображения пользовательского режима использует для уведомления среды выполнения Direct3D о том, будет ли среда выполнения запускать или прекращать прием вызовов функций обратного вызова среды выполнения из рабочего потока.

Только версии среды выполнения DirectX 9 и Direct 9L поддерживают функцию pfnSetAsyncCallbacksCb . DirectX 10 и более поздних версий среды выполнения присваивают члену pfnSetAsyncCallbacksCb значение NULL, когда среда выполнения вызывает функцию CreateDevice(D3D10) драйвера отображения пользовательского режима для создания устройства отрисовки.

pfnSetDisplayPrivateDriverFormatCb

Указатель на функцию pfnSetDisplayPrivateDriverFormatCb , которую драйвер отображения пользовательского режима использует для изменения формата общей основной поверхности.

pfnOfferAllocationsCb

Указатель на функцию pfnOfferAllocationsCb , которую вызывает драйвер отображения пользовательского режима WDDM 1.2 и более поздних версий, чтобы предложить выделение видеопамяли для повторного использования.