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