struttura D3DDDI_DEVICECALLBACKS (d3dumddi.h)

Articolo
02/06/2025

La struttura D3DDDI_DEVICECALLBACKS contiene le funzioni di callback di runtime di Microsoft Direct3D che il driver di visualizzazione in modalità utente può usare.

Sintassi

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;

Membri

pfnAllocateCb

Puntatore alla funzione pfnAllocateCb, che il driver di visualizzazione in modalità utente usa per richiedere che il runtime Direct3D crei un'allocazione di memoria da usare dal driver.

pfnDeallocateCb

Puntatore alla funzione pfnDeallocateCb , che il driver di visualizzazione in modalità utente usa per richiedere che la memoria disponibile in runtime Direct3D precedentemente allocata.

pfnSetPriorityCb

Puntatore alla funzione pfnSetPriorityCb, utilizzata dal driver di visualizzazione in modalità utente per impostare la priorità di una risorsa o di un elenco di allocazioni.

pfnQueryResidencyCb

Puntatore alla funzione pfnQueryResidencyCb, usata dal driver di visualizzazione in modalità utente per eseguire una query sullo stato di residenza di una risorsa o di un elenco di allocazioni.

pfnSetDisplayModeCb

Puntatore alla funzione pfnSetDisplayModeCb, che il driver di visualizzazione in modalità utente usa per impostare un'allocazione per la visualizzazione.

pfnPresentCb

Puntatore alla funzione pfnPresentCb, che il driver di visualizzazione in modalità utente usa per inviare un comando presente al driver miniport di visualizzazione.

pfnRenderCb

Puntatore alla funzione di pfnRenderCb, che il driver di visualizzazione in modalità utente usa per inviare un buffer dei comandi al driver miniport visualizzato.

pfnLockCb

Puntatore alla funzione pfnLockCb, che il driver di visualizzazione in modalità utente usa per richiedere un blocco dal driver miniport di visualizzazione. Questo blocco non può essere gestito completamente dal driver di visualizzazione in modalità utente.

pfnUnlockCb

Puntatore alla funzione pfnUnlockCb, che il driver di visualizzazione in modalità utente usa per chiamare il driver miniport di visualizzazione per uno sblocco. Questo sblocco non può essere gestito completamente dal driver di visualizzazione in modalità utente.

pfnEscapeCb

Puntatore alla funzione pfnEscapeCb, che il driver di visualizzazione in modalità utente usa per condividere informazioni con il driver display miniport.

pfnCreateOverlayCb

Puntatore alla funzione pfnCreateOverlayCb, usata dal driver di visualizzazione in modalità utente per creare e visualizzare un oggetto overlay in modalità kernel.

pfnUpdateOverlayCb

Puntatore alla funzione pfnUpdateOverlayCb, che il driver di visualizzazione in modalità utente usa per modificare un oggetto overlay in modalità kernel.

pfnFlipOverlayCb

Puntatore alla funzione pfnFlipOverlayCb, usata dal driver di visualizzazione in modalità utente per modificare l'allocazione visualizzata dalla sovrimpressione.

pfnDestroyOverlayCb

Puntatore alla funzione di pfnDestroyOverlayCb, che il driver di visualizzazione in modalità utente usa per distruggere un oggetto overlay in modalità kernel e impedire la visualizzazione della sovrimpressione.

pfnCreateContextCb

Puntatore alla funzione pfnCreateContextCb , usata dal driver di visualizzazione in modalità utente per creare un contesto a cui inviare le richieste.

pfnDestroyContextCb

Puntatore alla funzione di pfnDestroyContextCb, usata dal driver di visualizzazione in modalità utente per eliminare definitivamente un contesto che pfnCreateContextCb creato.

pfnCreateSynchronizationObjectCb

Puntatore alla funzione pfnCreateSynchronizationObjectCb, utilizzata dal driver di visualizzazione in modalità utente per creare un oggetto di sincronizzazione.

pfnDestroySynchronizationObjectCb

Puntatore alla funzione pfnDestroySynchronizationObjectCb, utilizzata dal driver di visualizzazione in modalità utente per eliminare definitivamente un oggetto di sincronizzazione che pfnCreateSynchronizationObjectCb creato.

pfnWaitForSynchronizationObjectCb

Puntatore alla funzione pfnWaitForSynchronizationObjectCb, che il driver di visualizzazione in modalità utente usa per attendere che si verifichino gli eventi di sincronizzazione e quindi usa per restituire.

pfnSignalSynchronizationObjectCb

Puntatore alla funzione pfnSignalSynchronizationObjectCb che il driver di visualizzazione in modalità utente usa per segnalare che gli eventi di sincronizzazione non sono più di proprietà di un contesto.

pfnSetAsyncCallbacksCb

Puntatore al pfnSetAsyncCallbacksCb funzione usata dal driver di visualizzazione in modalità utente per notificare al runtime Direct3D se il runtime inizierà o interromperà la ricezione di chiamate alle funzioni di callback del runtime da un thread di lavoro.

Solo le versioni DirectX 9 e Direct 9L del runtime supportano la funzione pfnSetAsyncCallbacksCb. DirectX 10 e versioni successive del runtime impostano la membro pfnSetAsyncCallbacksCb su NULL quando il runtime chiama il driver di visualizzazione in modalità utente CreateDevice(D3D10) funzione per creare un dispositivo di rendering.

pfnSetDisplayPrivateDriverFormatCb

Puntatore alla funzione pfnSetDisplayPrivateDriverFormatCb utilizzata dal driver di visualizzazione in modalità utente per modificare il formato della superficie primaria condivisa.

pfnOfferAllocationsCb

Puntatore alla funzione pfnOfferAllocationsCb, che una chiamata di driver in modalità utente WDDM 1.2 e versioni successive consente di offrire allocazioni di memoria video per il riutilizzo.