D3DDDIARG_CREATEDEVICE structure (d3dumddi.h)
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) |