D3DDDIARG_CREATEDEVICE structure

The D3DDDIARG_CREATEDEVICE structure contains information that describes the display device to create.

Syntax


typedef struct _D3DDDIARG_CREATEDEVICE {
  HANDLE                       hDevice;
  UINT                         Interface;
  UINT                         Version;
  const D3DDDI_DEVICECALLBACKS *pCallbacks;
  VOID                         *pCommandBuffer;
  UINT                         CommandBufferSize;
  D3DDDI_ALLOCATIONLIST        *pAllocationList;
  UINT                         AllocationListSize;
  D3DDDI_PATCHLOCATIONLIST     *pPatchLocationList;
  UINT                         PatchLocationListSize;
  D3DDDI_DEVICEFUNCS           *pDeviceFuncs;
  D3DDDI_CREATEDEVICEFLAGS     Flags;
#if (D3D_UMD_INTERFACE_VERSION >= D3D_UMD_INTERFACE_VERSION_WIN7)
  D3DGPU_VIRTUAL_ADDRESS       CommandBuffer;
#endif 
} D3DDDIARG_CREATEDEVICE;

Members

hDevice

[in/out] A handle to the display device (graphics context). On input to the CreateDevice function, hDevice specifies the handle that the driver should use when it calls back into the Microsoft Direct3D runtime.

The driver generates a unique handle and passes it back to the Direct3D runtime. On output from the CreateDevice function, hDevice specifies the handle that the Direct3D runtime uses in subsequent driver calls to identify the display device.

Interface

[in] The Direct3D/DirectDraw interface version (for example, 7, 8, or 9) that creates the device.

Version

[in] A number that the driver can use to identify when the Direct3D/DirectDraw runtime was built. For example, the driver can use the version number to differentiate between a runtime that is released with Windows Vista and a runtime that is released with a subsequent service pack, which might contain a fix that the driver requires.

pCallbacks

[in] A pointer to a D3DDDI_DEVICECALLBACKS structure that contains a table of Direct3D runtime callback functions that the driver can use.

pCommandBuffer

[in] Obsolete. To receive a pointer to the first buffer that the user-mode display driver can use to batch commands, the driver must first call the pfnCreateContextCb function to create a context for the newly created device.

CommandBufferSize

[in] Obsolete.

pAllocationList

[in] Obsolete. To receive an array of D3DDDI_ALLOCATIONLIST structures for the starting allocation list, the driver must first call the pfnCreateContextCb function to create a context for the newly created device.

AllocationListSize

[in] Obsolete.

pPatchLocationList

[in] Obsolete. To receive an array of D3DDDI_PATCHLOCATIONLIST structures for the starting patch-location list, the driver must first call the pfnCreateContextCb function to create a context for the newly created device.

PatchLocationListSize

[in] Obsolete.

pDeviceFuncs

[out] A pointer to a D3DDDI_DEVICEFUNCS structure that the user-mode display driver fills with a table of its functions. The Direct3D runtime uses these functions to communicate with the user-mode display driver.

Flags

[in] A D3DDDI_CREATEDEVICEFLAGS structure that identifies how to create the device.

CommandBuffer

This member is reserved and should be set to zero.

This member is available beginning with Windows 7.

Requirements

Version

Available in Windows Vista and later versions of the Windows operating systems.

Header

D3dumddi.h (include D3dumddi.h)

See also

CreateDevice
D3DDDI_CREATEDEVICEFLAGS
D3DDDI_DEVICECALLBACKS
D3DDDI_DEVICEFUNCS
DxgkDdiCreateDevice

 

 

Send comments about this topic to Microsoft

Show: