DeviceUpdateMode Class Reference

Defines how to treat the optional device image, when the device itself is updated. More...

Inherits object.

Static Public Attributes
int	NewDeviceImage = 1
	Creates a new device image keeping the old one intact. More...
int	UpdateDeviceImage = 0
	Updates the handle of any existing device image. More...

Detailed Description

Defines how to treat the optional device image, when the device itself is updated.

A method containing this as a parameter indicates a handle change. This invalidates the old handle in a way, that no interfaces are available anymore. The only thing remaining is the old ring buffer, but only with access to the last synchronized buffer.

If a method call containing this as a parameter succeeds, it is necessary for the client application to update the handle in objects, which only use handle.

Member Data Documentation

NewDeviceImage

int NewDeviceImage = 1

static

Creates a new device image keeping the old one intact.

Use this option if you still do processing on the old image data while performing the switch operation.

Attention

If you bound the old device image to a display or used it in another control to always access the current image data, keep in mind, that you need to assign the new device image of the device manually.

UpdateDeviceImage

int UpdateDeviceImage = 0

static

Updates the handle of any existing device image.

If unsure, use this as the default.

The result of this operation is that the currently active device image is moved to the new device image internally. The result is that the current image buffer is lost and replaced by an empty / black buffer.