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