DXGKDDI_CREATEDEVICE回呼函式 (d3dkmddi.h)

  • 發行項

DXGKDDI_CREATEDEVICE函式會建立圖形內容裝置，後續用於呼叫顯示迷你埠驅動程式的裝置特定功能。

語法

DXGKDDI_CREATEDEVICE DxgkddiCreatedevice;

NTSTATUS DxgkddiCreatedevice(
  IN_CONST_HANDLE hAdapter,
  INOUT_PDXGKARG_CREATEDEVICE pCreateDevice
)
{...}

參數

hAdapter

[in]與顯示配接器相關聯的內容區塊句柄。 顯示迷你埠驅動程式先前在 DXGKDDI_ADD_DEVICE 函式的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

另請參閱

DXGKARG_CREATEDEVICE

DXGKDDI_ADD_DEVICE