PFND3DDDI_CREATEDEVICE回呼函式 (d3dumddi.h)

CreateDevice 函式會建立後續呼叫中所參考的圖形內容。

語法

PFND3DDDI_CREATEDEVICE Pfnd3dddiCreatedevice;

HRESULT Pfnd3dddiCreatedevice(
  HANDLE hAdapter,
  D3DDDIARG_CREATEDEVICE *unnamedParam2
)
{...}

hAdapter

識別圖形配接器的句柄。

unnamedParam2

pCreateData [in， out]

D3DDDIARG_CREATEDEVICE 結構的指標。在輸入上，此結構包含驅動程式可以使用的資訊。在輸出時，驅動程式會指定 Microsoft Direct3D 執行時間可以使用的結構中的資訊。

CreateDevice 會傳回下列其中一個值：

傳回碼	描述
S_OK	已成功建立圖形內容。
E_OUTOFMEMORY	CreateDevice 無法配置完成所需的記憶體。

顯示裝置是用來保存轉譯狀態集合的圖形內容。在指定的配接器上，同一個程式可以建立多個裝置。請注意，可以同時存在的顯示裝置數目只受限於可用的系統記憶體。也就是說，驅動程式無法硬式編碼最大裝置限制。

一般而言，裝置彼此獨立，因此一個裝置中建立的資源無法參考或存取在另一個裝置中建立的資源。不過，跨進程資源是此規則的例外狀況。

當 Direct3D 執行時間呼叫 CreateDevice 來建立裝置時，運行時間不會建立預設圖形處理單位， (GPU) 裝置執行的內容線程。驅動程式必須明確呼叫 pfnCreateContextCb 函式，才能視需要建立一或多個內容。

需求	值
最低支援的用戶端	可在 Windows Vista 和更新版本的 Windows 作業系統中使用。
目標平台	桌面
標頭	d3dumddi.h (include D3dumddi.h)