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