User-Mode 顯示驅動程式呼叫的 Direct3D 執行時間函式

發行項
02/02/2024

本主題列出 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 Graphics Infrastructure (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;因此，高水位線可改善這類位置之間的周遊。