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) |