D3DDDIARG_CREATEDEVICE 結構 (d3dumddi.h)

D3DDDIARG_CREATEDEVICE 結構包含描述要建立之顯示裝置的資訊。

語法

typedef struct _D3DDDIARG_CREATEDEVICE {
  [in/out] HANDLE                       hDevice;
  [in]     UINT                         Interface;
  [in]     UINT                         Version;
  [in]     const D3DDDI_DEVICECALLBACKS *pCallbacks;
  [in]     VOID                         *pCommandBuffer;
  [in]     UINT                         CommandBufferSize;
  [in]     D3DDDI_ALLOCATIONLIST        *pAllocationList;
  [in]     UINT                         AllocationListSize;
  [in]     D3DDDI_PATCHLOCATIONLIST     *pPatchLocationList;
  [in]     UINT                         PatchLocationListSize;
           D3DDDI_DEVICEFUNCS           *pDeviceFuncs;
  [in]     D3DDDI_CREATEDEVICEFLAGS     Flags;
           D3DGPU_VIRTUAL_ADDRESS       CommandBuffer;
} D3DDDIARG_CREATEDEVICE;

成員

[in/out] hDevice

顯示裝置的句柄 (圖形內容) 。 在 CreateDevice 函式的輸入上， hDevice 會指定驅動程式在呼叫回 Microsoft Direct3D 運行時間時應該使用的句柄。

驅動程式會產生唯一的句柄，並將它傳回 Direct3D 運行時間。 在 CreateDevice 函式的輸出上， hDevice 會指定 Direct3D 執行時間在後續驅動程式呼叫中用來識別顯示裝置的句柄。

[in] Interface

Direct3D/DirectDraw 介面版本 (例如建立裝置的 7、8 或 9) 。

[in] Version

驅動程式可用來識別何時建置 Direct3D/DirectDraw 運行時間的數位。 例如，驅動程式可以使用版本號碼來區分使用 Windows Vista 發行的運行時間，以及後續 Service Pack 發行的運行時間，其中可能包含驅動程式所需的修正程式。

[in] pCallbacks

D3DDDI_DEVICECALLBACKS 結構的指標，其中包含驅動程式可以使用的 Direct3D 運行 時間 回呼函式數據表。

[in] pCommandBuffer

已過時。 若要接收使用者模式顯示驅動程式可用來批處理命令的第一個緩衝區指標，驅動程式必須先呼叫 pfnCreateContextCb 函式來建立新建立裝置的內容。

[in] CommandBufferSize

已過時。

[in] pAllocationList

已過時。 若要接收開始配置清單 D3DDDI_ALLOCATIONLIST 結構的數位，驅動程式必須先呼叫 pfnCreateContextCb 函式，才能為新建立的裝置建立內容。

[in] AllocationListSize

已過時。

[in] pPatchLocationList

已過時。 若要接收開始修補位置清單 之D3DDDI_PATCHLOCATIONLIST 結構的數位，驅動程序必須先呼叫 pfnCreateContextCb 函式，才能為新建立的裝置建立內容。

[in] PatchLocationListSize

已過時。

pDeviceFuncs

[out]使用者模式顯示驅動程式填滿其函式數據表 之D3DDDI_DEVICEFUNCS 結構的指標。 Direct3D 執行時間會使用這些函式來與使用者模式顯示驅動程序通訊。

[in] Flags

識別如何建立裝置 的D3DDDI_CREATEDEVICEFLAGS 結構。

CommandBuffer

這個成員是保留的，而且應該設定為零。

此成員從 Windows 7 開始可供使用。

規格需求

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

另請參閱

CreateDevice

D3DDDI_CREATEDEVICEFLAGS

D3DDDI_DEVICECALLBACKS

D3DDDI_DEVICEFUNCS

DxgkDdiCreateDevice