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