Device.Device Constructor

Language:

How Do I...?

Maintain Floating Point Precision after Device Creation

Initializes a new instance of the current class.

Definition

Visual Basic Public Sub New( _
    ByVal pUnk As IDirect3DDevice9 _
)

C# public Device(
    IDirect3DDevice9 pUnk
);

C++ public:
Device(
    IDirect3DDevice9 pUnk
);

JScript public function Device(
    pUnk : IDirect3DDevice9
);

Visual Basic	Public Sub New( _ ByVal pUnk As IDirect3DDevice9 _ )
C#	public Device( IDirect3DDevice9 pUnk );
C++	public: Device( IDirect3DDevice9 pUnk );
JScript	public function Device( pUnk : IDirect3DDevice9 );

Parameters

pUnk Microsoft.DirectX.PrivateImplementationDetails.IDirect3DDevice9
Unmanaged Component Object Model (COM) IDirect3DDevice9 interface pointer.

Remarks

Exceptions

DeviceLostException The device has been lost but cannot be reset at this time. Therefore, rendering is not possible.

InvalidCallException The method call is invalid. For example, a method's parameter may have an invalid value.

NotAvailableException This device does not support the queried technique.

OutOfVideoMemoryException Direct3D does not have enough display memory to perform the operation.

This constructor creates a fully functional device object that is set to the required display mode (or windowed mode) and allocated with the appropriate back buffers. To begin rendering, the application needs only to create and set a depth buffer (assuming EnableAutoDepthStencil is false in PresentParameters).

Note that the HardwareVertexProcessing, MixedVertexProcessing, and SoftwareVertexProcessing vertex flags are mutually exclusive, and that at least one must be specified when calling this method.

Back buffers created as part of the device are lockable only if LockableBackBuffer is specified in PresentParameters. Multisampled back buffers and depth surfaces are never lockable.

The Device.Reset and Device.TestCooperativeLevel methods must be called from the same thread that used this method to create a device.

The Format.Unknown type can be specified for the windowed mode back-buffer format when calling Device, Device.Reset, and SwapChain.SwapChain(Device, PresentParameters) (the constructor override for creating a new swap chain). This means the application does not have to query the current desktop format before calling Device for windowed mode. For full-screen mode, the back-buffer format must be specified.

The Device method fails if an attempt is made to create a device on a 0x0-sized window.

How Do I...?

Maintain Floating Point Precision after Device Creation

When a Device object is created, the common language runtime will change the floating-point unit (FPU) to single precision to maintain better performance. To maintain the default double precision FPU, which is default for the common language runtime, use the CreateFlags.FpuPreserve flag when creating a Device object as in the sample code below.
[C#]
Device device = null;              // Create rendering device
	PresentParameters presentParams = new PresentParameters();

	device = new Device(0, DeviceType.Hardware, this, 
			CreateFlags.SoftwareVertexProcessing | 
			CreateFlags.FpuPreserve, presentParams);

DeviceLostException	The device has been lost but cannot be reset at this time. Therefore, rendering is not possible.
InvalidCallException	The method call is invalid. For example, a method's parameter may have an invalid value.
NotAvailableException	This device does not support the queried technique.
OutOfVideoMemoryException	Direct3D does not have enough display memory to perform the operation.