D3DDEVICE_CREATION_PARAMETERS

Describes the creation parameters for a device.

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 IDirect3D8 methods. Note that different instances of Direct3D8 objects may use different ordinals. For example, adapters can enter and leave a system due to users adding or subtracting monitors from a multiple monitor system, or due to hot-swapping a laptop. Consequently, you should use this ordinal only in a Direct3D8 known to be valid. The only two valid Direct3D8 instances are the Direct3D8 that created this IDirect3DDevice8 interface and the Direct3D8 returned from IDirect3DDevice8::GetDirect3D,as called through this IDirect3DDevice8 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 IDirect3D8::CreateDevice call that created this device.

hFocusWindow

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

BehaviorFlags

A combination of one or more of the following flags that control global behaviors of the Microsoft® Direct3D® device.

D3DCREATE_FPU_PRESERVE

The calling application does not want Direct3D to modify the FPU state in ways that are visible to the application. In this mode, Direct3D saves and restores the FPU state every time it needs to modify the FPU state.

D3DCREATE_HARDWARE_VERTEXPROCESSING

Specifies hardware vertex processing.

D3DCREATE_MIXED_VERTEXPROCESSING

Specifies mixed (both software and hardware) vertex processing.

D3DCREATE_MULTITHREADED

Requests multithread-safe behavior. This causes Direct3D to take the global critical section more frequently.

D3DCREATE_PUREDEVICE

Specifies hardware rasterization, transform, lighting, and shading.

D3DCREATE_SOFTWARE_VERTEXPROCESSING

Specifies software vertex processing.

The value of this parameter mirrors the value passed to the IDirect3D8::CreateDevice call that created this device.

Requirements

  Header: Declared in D3d8types.h.

See Also

IDirect3DDevice8::GetCreationParameters, IDirect3D8::CreateDevice