Edit

D3DDDIARG_CREATEDEVICE structure (d3dumddi.h)

  • Article

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

Syntax

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;

Members

[in/out] hDevice

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.

[in] Interface

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

[in] Version

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.

[in] pCallbacks

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

[in] pCommandBuffer

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.

[in] CommandBufferSize

Obsolete.

[in] pAllocationList

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.

[in] AllocationListSize

Obsolete.

[in] pPatchLocationList

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.

[in] PatchLocationListSize

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.

[in] Flags

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

Requirement Value
Minimum supported client 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