| CanvasDevice Class |
Devices are used to create graphics resources and drawing sessions.
Most apps should use the CanvasControl wrapper instead of directly managing their own CanvasDevice.
Inheritance HierarchySystem.Object
Microsoft.Graphics.Canvas.CanvasDevice
Microsoft.Graphics.Canvas.CanvasDevice
Namespace: Microsoft.Graphics.Canvas
Assembly: Microsoft.Graphics.Canvas (in Microsoft.Graphics.Canvas.dll) Version: 0.0.0.0
SyntaxC#
public sealed class CanvasDevice : IDisposable, ICanvasResourceCreator, IDirect3DDevice
The CanvasDevice type exposes the following members.
Constructors| Name | Description | |
|---|---|---|
 | CanvasDevice() | Initializes a new instance of the CanvasDevice class. |
| CanvasDevice(Boolean) | Initializes a new instance of the CanvasDevice class. |
Properties| Name | Description | |
|---|---|---|
  | DebugLevel | Gets or sets the debug level for devices when they are created. |
| Device | Implements the ICanvasResourceCreator interface by returning 'this'. |
| ForceSoftwareRenderer | Gets the value of the forceSoftwareRendering parameter that was specified when this device was created. |
| LowPriority | Reduces the priority of drawing work submitted to this device. |
| MaximumBitmapSizeInPixels | Reports the maximum size of bitmaps supported on this device, in pixels. |
| MaximumCacheSize |
Sets the maximum amount of memory (in bytes) that can be accumulated for cached
images and intermediate surfaces.
|
Methods| Name | Description | |
|---|---|---|
| CreateFromDirect3D11Device | Creates a CanvasDevice that will use the specified IDirect3DDevice. |
| Dispose | Releases all resources used by the CanvasDevice. |
| GetSharedDevice() | Gets a device that can be shared between multiple different rendering components, such as controls. |
| GetSharedDevice(Boolean) | Gets a device that can be shared between multiple different rendering components, such as controls. |
| IsBufferPrecisionSupported | Checks whether the specified buffer precision is supported on this device. |
| IsDeviceLost | Returns whether this device has lost the ability to be operational. |
| IsPixelFormatSupported | Checks whether the specified pixel format is supported on this device. |
| Lock | Locks the device for the current thread. |
| RaiseDeviceLost | Raises an event on the device, indicating that it is no longer operational. |
| Trim | Trims any graphics memory allocated by the graphics device on the app's behalf. |
Events| Name | Description | |
|---|---|---|
 | DeviceLost | Subscribe to this event to be notified whenever the device ceases to be operational. |
RemarksWhen using Direct2D interop, this Win2D class corresponds to the Direct2D interface ID2D1Device1.
See Also