D3DDEVICE_CREATION_PARAMETERS structure

Describes the creation parameters for a device.

Syntax

typedef struct D3DDEVICE_CREATION_PARAMETERS {
  UINT       AdapterOrdinal;
  D3DDEVTYPE DeviceType;
  HWND       hFocusWindow;
  DWORD      BehaviorFlags;
} D3DDEVICE_CREATION_PARAMETERS, *LPD3DDEVICE_CREATION_PARAMETERS;

Members

AdapterOrdinal

Type: UINT

Ordinal number that denotes the display adapter. D3DADAPTER_DEFAULT is always the primary display adapter. Use this ordinal as the Adapter parameter for any of the IDirect3D9 methods. Note that different instances of Direct3D 9.0 objects can use different ordinals. Adapters can enter or leave a system when users, for example, add or remove monitors from a multiple-monitor system or when they hot-swap a laptop. Consequently, use this ordinal only in a Direct3D 9.0 instance known to be valid, that is, either the Direct3D 9.0 that created this IDirect3DDevice9 interface or the Direct3D 9.0 returned from GetDirect3D, as called through this IDirect3DDevice9 interface.

DeviceType

Type: D3DDEVTYPE

Member of the D3DDEVTYPE enumerated type. Denotes the amount of emulated functionality for this device. The value of this parameter mirrors the value passed to the CreateDevice call that created this device.

hFocusWindow

Type: HWND

Window handle to which focus belongs for this Direct3D device. The value of this parameter mirrors the value passed to the CreateDevice call that created this device.

BehaviorFlags

Type: DWORD

A combination of one or more D3DCREATE constants that control global behavior of the device. These constants mirror the constants passed to CreateDevice when the device was created.

Requirements

Requirement Value
Header
D3D9Types.h

See also

Direct3D Structures

GetCreationParameters

CreateDevice