D3D10DDIARG_CREATEDEVICE structure

The D3D10DDIARG_CREATEDEVICE structure describes the display device to create.

Syntax


typedef struct D3D10DDIARG_CREATEDEVICE {
  D3D10DDI_HRTDEVICE            hRTDevice;
  UINT                          Interface;
  UINT                          Version;
  const D3DDDI_DEVICECALLBACKS  *pKTCallbacks;
  union {
    D3D10DDI_DEVICEFUNCS      *pDeviceFuncs;
#if D3D10DDI_MINOR_HEADER_VERSION >= 1 || D3D11DDI_MINOR_HEADER_VERSION >= 1
    D3D10_1DDI_DEVICEFUNCS    *p10_1DeviceFuncs;
#endif 
#if D3D11DDI_MINOR_HEADER_VERSION >= 1
    D3D11DDI_DEVICEFUNCS      *p11DeviceFuncs;
#endif 
#if D3D11DDI_MINOR_HEADER_VERSION >= 3
    D3D11_1DDI_DEVICEFUNCS    *p11_1DeviceFuncs;
#endif 
#if D3D11DDI_MINOR_HEADER_VERSION >= 4
    D3DWDDM1_3DDI_DEVICEFUNCS *pWDDM1_3DeviceFuncs;
#endif 
  };
  D3D10DDI_HDEVICE              hDrvDevice;
  DXGI_DDI_BASE_ARGS            DXGIBaseDDI;
  D3D10DDI_HRTCORELAYER         hRTCoreLayer;
  union {
    const D3D10DDI_CORELAYER_DEVICECALLBACKS *pUMCallbacks;
#if D3D11DDI_MINOR_HEADER_VERSION >= 1
    const D3D11DDI_CORELAYER_DEVICECALLBACKS *p11UMCallbacks;
#endif 
  };
  UINT                          Flags;
#if D3D11DDI_MINOR_HEADER_VERSION >= 3
  PFND3D10DDI_RETRIEVESUBOBJECT *ppfnRetrieveSubObject;
#endif 
} D3D10DDIARG_CREATEDEVICE;

Members

hRTDevice

[in] A handle to the display device (graphics context) that specifies the handle that the driver should use when it calls back into the Direct3D runtime (that is, when the driver calls functions that the pKTCallbacks member specifies).

Interface

[in] The Direct3D interface version. The high 16 bits store the major release number (such as 10, 11, and so on); the low 16 bits store the minor release number (such as 0, 1, 2, and so on). The minor release number will be increased when a change to the interface is released.

Version

[in] A number that the driver can use to identify when the Direct3D runtime was built. The high 16 bits represent the build number; the low 16 bits represent the revision number.

The driver is required only to monitor the high 16 bits. The driver should ensure that the runtime build version that is passed in is greater than or equal to the current build version of the driver. The driver should return a failure from its CreateDevice(D3D10) function if the passed in build version is incompatible.

pKTCallbacks

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

pDeviceFuncs

[in/out] A pointer to a D3D10DDI_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.

The driver should fill its Direct3D version 10.0 functions in the supplied D3D10DDI_DEVICEFUNCS structure when the value in the Interface member is D3D10_0_DDI_INTERFACE_VERSION.

p10_1DeviceFuncs

[in/out] A pointer to a D3D10_1DDI_DEVICEFUNCS structure that the user-mode display driver fills with a table of its functions. Version 10.1 of the Direct3D runtime uses these functions to communicate with the user-mode display driver.

The driver should fill its Direct3D version 10.1 functions in the supplied D3D10_1DDI_DEVICEFUNCS structure when the value in the Interface member is D3D10_1_DDI_INTERFACE_VERSION.

Supported starting with Windows Vista with SP1 and Windows Server 2008.

p11DeviceFuncs

[in/out] A pointer to a D3D11DDI_DEVICEFUNCS structure that the user-mode display driver fills with a table of its functions. Version 11 of the Direct3D runtime uses these functions to communicate with the user-mode display driver.

The driver should fill its Direct3D version 11.0 functions in the supplied D3D11DDI_DEVICEFUNCS structure when the value in the Interface member is D3D11_0_DDI_INTERFACE_VERSION.

Supported starting with Windows 7.

p11_1DeviceFuncs

[in/out] A pointer to a D3D11_1DDI_DEVICEFUNCS structure that the user-mode display driver fills with a table of its functions. Starting with version 11.1, the Direct3D runtime uses these functions to communicate with the user-mode display driver.

The driver should fill its Direct3D version 11.1 functions in the supplied D3D11_1DDI_DEVICEFUNCS structure when the value in the Interface member is D3D11_1_DDI_INTERFACE_VERSION.

Supported starting with Windows 8.

pWDDM1_3DeviceFuncs

[in/out] A pointer to a D3DWDDM1_3DDI_DEVICEFUNCS structure that the user-mode display driver fills with a table of its functions. Version 11.2 of the Direct3D runtime uses these functions to communicate with the user-mode display driver.

The driver should fill its Direct3D version 11.2 functions in the supplied D3DWDDM1_3DDI_DEVICEFUNCS structure when the value in the Interface member is D3DWDDM1_3_DDI_INTERFACE_VERSION.

Supported starting with Windows 8.1.

hDrvDevice

[in/out] A handle to the display device (graphics context) that the Direct3D runtime uses in subsequent driver calls to identify the display device.

DXGIBaseDDI

[in/out] A DXGI_DDI_BASE_ARGS structure that provides access to the DXGI. The DXGI DDI handles low-level tasks like presenting rendered frames to an output, controlling gamma, and managing a full-screen transition.

hRTCoreLayer

[in] A handle that the driver should use when it calls back into the Direct3D runtime to access core Direct3D 10 functionality (that is, when the driver calls functions that the pUMCallbacks member specifies).

pUMCallbacks

[in] A pointer to a D3D10DDI_CORELAYER_DEVICECALLBACKS structure that contains a table of Direct3D 10 runtime callback functions that the driver can use to access core user-mode runtime functionality.

p11UMCallbacks

[in] A pointer to a D3D11DDI_CORELAYER_DEVICECALLBACKS structure that contains a table of Direct3D 11 runtime callback functions, which the driver can use to access core user-mode runtime functionality.

Supported starting with Windows 7.

Flags

[in] A valid bitwise OR of flag values that identify how to create the display device. The Direct3D runtime supports the following flags:

D3D10DDI_CREATEDEVICE_FLAG_DISABLE_EXTRA_THREAD_CREATION (0x1)

If this flag is set, the user-mode display driver should not run multiple threads simultaneously when it processes calls to its functions from the Direct3D runtime. A driver can typically start and run multiple threads to process operations faster, unless the D3D10DDI_CREATEDEVICE_FLAG_DISABLE_EXTRA_THREAD_CREATION flag is set.

D3D11DDI_CREATEDEVICE_FLAG_SINGLETHREADED (0x10)

This flag informs the user-mode display driver that the application is single threaded. The Direct3D 11 runtime allows multiple application threads to enter the driver if the driver allows this mode of operation. However, not all applications can run multiple threads. If this flag is set, the driver does not expect multiple threads to enter it and run simultaneously. The driver can avoid synchronization if this flag is set.

Supported starting with Windows 7.

The flag that is set in the 0xE mask of the Flags member

This flag represents the level of 3-D pipeline that the driver should support for the display device. The driver uses the following constant and macros to extract one of the values from the D3D11DDI_3DPIPELINELEVEL enumeration that represent the 3-D pipeline level to support. The value in the Flags member is formatted like the Caps member of the D3D11DDI_3DPIPELINESUPPORT_CAPS structure.


#define D3D11DDI_CREATEDEVICE_FLAG_3DPIPELINESUPPORT_SHIFT (0x1)
#define D3D11DDI_CREATEDEVICE_FLAG_3DPIPELINESUPPORT_MASK (0x7 << D3D11DDI_CREATEDEVICE_FLAG_3DPIPELINESUPPORT_SHIFT)
#define D3D11DDI_EXTRACT_3DPIPELINELEVEL_FROM_FLAGS( Flags ) \
    ((D3D11DDI_3DPIPELINELEVEL)(((Flags) & D3D11DDI_CREATEDEVICE_FLAG_3DPIPELINESUPPORT_MASK) >> \
    D3D11DDI_CREATEDEVICE_FLAG_3DPIPELINESUPPORT_SHIFT))

Supported starting with Windows 7.

ppfnRetrieveSubObject

[in/out] A pointer to a RetrieveSubObject(D3D11_1) function that retrieves subparts of a Direct3D driver device object.

Supported starting with Windows 8.

Remarks

The driver examines values in the Interface and Version members to determine whether to fill the D3D10DDI_DEVICEFUNCS, D3D10_1DDI_DEVICEFUNCS, D3D11DDI_DEVICEFUNCS, D3D11_1DDI_DEVICEFUNCS, or D3DWDDM1_3DDI_DEVICEFUNCS structure that the pDeviceFuncs, p10_1DeviceFuncs, p11DeviceFuncs, p11_1DeviceFuncs, or pWDDM1_3DeviceFuncs member points to with the driver's functions. The following constants from D3d10umddi.h are examples of the constants that the driver might find in Interface and Version:


#define D3D10_1_DDI_MINOR_VERSION 2
#define D3D10_1_DDI_INTERFACE_VERSION ((D3D10_DDI_MAJOR_VERSION << 16) | D3D10_1_DDI_MINOR_VERSION)
#define D3D10_1_DDI_BUILD_VERSION 1
#define D3D10_1_DDI_SUPPORTED ((((UINT64)D3D10_1_DDI_INTERFACE_VERSION) << 32) | (((UINT64)D3D10_1_DDI_BUILD_VERSION) << 16))

Other possible combinations of constants for different versions of the operating system, Direct3D, and Windows Display Driver Model (WDDM) are listed in the D3d10umddi.h header.

Requirements

Version

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

Header

D3d10umddi.h (include D3d10umddi.h)

See also

CreateDevice(D3D10)
D3D10_1DDI_DEVICEFUNCS
D3D10DDI_CORELAYER_DEVICECALLBACKS
D3D11DDI_CORELAYER_DEVICECALLBACKS
D3D10DDI_DEVICEFUNCS
D3D11_1DDI_DEVICEFUNCS
D3D11DDI_3DPIPELINELEVEL
D3D11DDI_3DPIPELINESUPPORT_CAPS
D3D11DDI_DEVICEFUNCS
D3DWDDM1_3DDI_DEVICEFUNCS
D3DDDI_ALLOCATIONLIST
D3DDDI_DEVICECALLBACKS
D3DDDI_PATCHLOCATIONLIST
DXGI_DDI_BASE_ARGS
DxgkDdiCreateDevice
RetrieveSubObject(D3D11_1)

 

 

Send comments about this topic to Microsoft

Show: