D3DDEVICE_CREATION_PARAMETERS

  • Article

This structure describes the creation parameters for a device.

typedef struct _D3DDEVICE_CREATION_PARAMETERS {
  UINT AdapterOrdinal;
  D3DDEVTYPE DeviceType;
  DWORD hFocusWindow;
  HWND  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.

    Flag Description
    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. This flag is only applicable to x86 platforms.
    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

OS Versions: Windows CE .NET 4.0 and later.
Header: D3d8types.h.

See Also

IDirect3DDevice8::GetCreationParameters | IDirect3D8::CreateDevice | Direct3D Structures

 Last updated on Thursday, April 08, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.