2．9．可用的接口
本章用伪代码列出在2.3章介绍过的最重要的接口。对每个接口，实际的实现可以提供更多的方法，例如，除了SetValue(value)方法，还可以用直接映射到SetValue()的方式来实现operator=(value)方法。而且，实际的变量类型也可以不一样，例如，相对于伪代码中的类型string，实际的实现可以是Cstring，std::string或其它的类型。
在第2.8章可以找到更完整的解释。
2．9．1．IInteger接口
l int64 GetValue() – 返回值
l void SetValue( int64 ) – 设定值
l int64 GetMin() – 返回最小值
l int64 GetMax() – 返回最大值
l int64 GetInc() – 返回increment
l ERepresentation GetRepresentation() – 返回枚举型一样的数据
2．9．2．IFloat接口
l double GetValue() – 返回值
l void SetValue( double ) –设定值
l double GetMin() –返回最小值
l double GetMax() –返回最大值
l ERepresentation GetRepresentation() –返回枚举型一样的数据
l string GetUnit() – 返回单位
2．9．3．IString接口
l string GetValue() –返回值
l void SetValue( string ) –设定值
l int64 GetMaxLenght() – 返回字符串的最大长度
2．9．4．IEnumeration接口
l string GetStringValue() – 把枚举型当做字符串返回
l void SetStringValue( string ) –把枚举型当做字符串设置
l int64 GetIntValue() – 返回枚举数据相对应的索引值
l void SetIntValue( int64 ) –设置枚举数据相对应的索引值
l EnumEntryList GetEntries() – 返回一个指向枚举型的EnumEntry节点的指针的列表
2．9．5．ICommand接口
l void Execute() – 执行这个命令
l boolean IsDone() – 如果命令已经执行，返回true；还在执行，返回false
2．9．6．IBoolean接口
l boolean GetValue() – 返回值
l void SetValue( boolean ) –设定值
2．9．7．IRegister接口
l void Get( uint8 *pBuffer, int64 Length ) – 取得寄存器的内容，放入缓冲区
l void Set( uint8 *pBuffer, int64 Length ) – 从缓冲区取出数据，设置寄存器内
l int64 GetAddress() – 取得寄存器的地址
l int64 GetLength() – 取得寄存器的长度，单位字节
2．9．8．ICategory接口
l NodeList GetFeatures() – 返回一个指向属性节点的指针的列表
2．9．9．IPort接口
l void Read( uint8 *pBuffer, int64 Address, int64 Length ) – 从设备上读一组字节，读的位置是 [Address, Address+Length]
l void Write( uint8 *pBuffer, int64 Address, int64 Length ) – 写一组字节到设备上，写的位置是 [Address, Address+Length]
2．9．10．ISelector接口
l boolean IsSelector() – 说明节点是否是一个选择器
l NodeList GetSelectedFeatures() – 返回一个指针的列表，指针指向由当前节点选择的属性节点
2．10．标准属性列表
GenApi允许你根据名称、接口类型和含义，来定义抽象属性，并让它们为统一的API和GUI所接受。但是，GenApi不为某种特定的设备，例如相机，提供定义好的属性。这些标准属性列表是分开提供的。不过，GenApi通过NameSpace和StandardNameSpace属性的方式支持这些列表。（参见2.8.1）。
虽然创建标准属性列表的组织的工作并没有受到多少限制，GenApi本身定义了一些属性，这些属性必须在每个标准属性列表钟提供：
|
接口 |
名称 |
含义 |
|
ICategory |
Root |
属性树的root |
|
IPort |
Device |
设备的默认端口 |
|
IBoolean |
TLParamsLocked |
Implements a flag served by the transport layer indication that it is set up for streaming. |