DXGKDDI_CREATEDEVICE回呼函式 (d3dkmddi.h)
DXGKDDI_CREATEDEVICE函式會建立圖形內容裝置,後續用於呼叫顯示器迷你埠驅動程式的裝置特定功能。
語法
DXGKDDI_CREATEDEVICE DxgkddiCreatedevice;
NTSTATUS DxgkddiCreatedevice(
IN_CONST_HANDLE hAdapter,
INOUT_PDXGKARG_CREATEDEVICE pCreateDevice
)
{...}
參數
hAdapter
[in]與顯示配接器相關聯的內容區塊句柄。 顯示迷你埠驅動程式先前在 DxgiDdiAddDevice 函式的 MiniportDeviceContext 輸出參數中,將此句柄提供給 Dxgkrnl。
pCreateDevice
[in/out]描述圖形內容裝置 之DXGKARG_CREATEDEVICE 結構的指標。
傳回值
DXGKDDI_CREATEDEVICE 會傳回下列其中一個值:
傳回碼 | Description |
---|---|
STATUS_SUCCESS | DXGKDDI_CREATEDEVICE 已成功建立圖形內容裝置。 |
STATUS_NO_MEMORY | DXGKDDI_CREATEDEVICE 無法配置完成所需的記憶體。 |
備註
Dxgkrnl 會呼叫 display miniport 驅動程式 的 DXGKDDI_CREATEDEVICE 函式,以建立圖形子系統後續將呼叫傳遞給顯示器迷你埠驅動程式的圖形內容裝置。 驅動程式會使用裝置來保存轉譯狀態的集合。 圖形子系統可以在指定的圖形處理器上建立多個裝置, (GPU) 配接器。
注意
可以同時存在的裝置數目只受限於可用的系統記憶體。 也就是說,驅動程式不能有硬式編碼的最大裝置限制。
一般而言,裝置彼此獨立;換句話說,無法在某個裝置中建立的資源參考或存取在另一部裝置中建立的資源。 不過,跨進程資源是此規則的例外狀況。
DXGKDDI_CREATEDEVICE 應設為可分頁。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows Vista |
目標平台 | 桌面 |
標頭 | d3dkmddi.h |
IRQL | PASSIVE_LEVEL |