Back to Aurora Vision Library website

You are here: Start » Function Reference » GenApi » GenApi_WriteRegisterData

GenApi_WriteRegisterData


Header: Genicam.h
Namespace: avl
Module: Genicam

Writes raw binary data into the objects memory using the IRegister interface.

Syntax

C++
C#
 
void avl::GenApi_WriteRegisterData
(
	GenApiHandle inHandle,
	const char* inParameterName,
	const void* inData,
	atl::sint64 inLength,
	bool inVerifyAccess = true
)

Parameters

Name Type Default Description
Input value inHandle GenApiHandle Handle to object providing GenApi interface.
Input value inParameterName const char* Textual name of the parameter that should be accessed in GenICam naming convention or device specific name. Parameter name is case sensitive.
Input value inData const void* Data that should be written to the parameter.
Input value inLength sint64 Size of the data to be written.
Input value inVerifyAccess bool true True to verify the parameter access.

Description

This function accesses the configuration of a device or software module using the GenICam GenApi interface. The actual GenApi interface is accessed through the handle of opened device or software module provided by other subsystem (like opened GigEVision device handle). A call to this function may result in time expensive (blocking) data exchange with the device.

Application provides a pointer on the data to write in the inData parameter, inLength specifies the amount (in bytes) of data to write (starting on the beginning of the register). GenApi_GetRegisterDescriptor can be used to determine the register size.

Set inVerifyAccess argument to true to check parameter state. When this argument is set to false accessing parameter in an improper device state may silently fail, the result is undefined.

Refer to the device documentation or use Device Manager to find a proper parameter name.

Exceptions

This function will throw an exception in the following situations:

  • Object handle is invalid does not provide the GenApi interface.
  • GenApi description does not provide a parameter with specified name.
  • Named parameter does not provide the IRegister interface.
  • Null pointer is provided on the inData parameter.
  • Requested data write size is larger than the range of the register.
  • Connection with device is lost.
  • Other unexpected GenICam or connection error occurred.

Errors

List of possible exceptions:

Error type Description
DomainError Null pointer on inData parameter.