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