?/TD>
Microsoft DirectX 9.0

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;

Members

AdapterOrdinal

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 Microsoft?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 IDirect3DDevice9::GetDirect3D, as called through this IDirect3DDevice9 interface.

DeviceType
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 IDirect3D9::CreateDevice call that created this device.
hFocusWindow
Window handle to which focus belongs for this Direct3D device. The value of this parameter mirrors the value passed to the IDirect3D9::CreateDevice call that created this device.
BehaviorFlags

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

Structure Information

Headerd3d9types.h
Minimum operating systems Windows 98

See Also

IDirect3DDevice9::GetCreationParameters, IDirect3D9::CreateDevice


© 2002 Microsoft Corporation. All rights reserved.