Add Repeated Capability Dialog

Name

Specifies the repeated capability name. This name serves as a unique identifier for the repeated capability. The name chosen here is registered by the driver installer in the IVI Configuration Store.

Parent

Repeated capabilities can be nested. For instance, an instrument may have multiple channels where each channel has multiple traces. This would be modeled in an IVI driver by creating a Channel repeated capability and then creating a Trace repeated capability with its parent set to be the Channel repeated capability.

For IVI-C drivers, only parameter-style repeated capabilities can be nested -- selector-style repeated capabilities cannot be nested, as per the IVI specifications. Thus, the Parent repeated capability combo box is disabled when the Style is set to Selector.

Style

The type of repeated capability to be added to the driver.

Parameter-style should almost always be the style chosen for IVI-C drivers. Selector-style is for special circumstances that typically do not occur in instrument-specific driver APIs.

A discussion of the three types of IVI repeated capabilities can be found in the topic Repeated Capabilities.

Dynamic

Indicates if the driver supports dynamic repeated capability names. Dynamic repeated capabilities allow the driver to decide at runtime what repeated capability names the driver supports, often based on information it reads from the instrument during the driver's initialization sequence.

If checked, an override of the function GetDynamicRepCapNames(String, IListString) must be manually added to the appropriate class in the driver project. See the topic Implementing Dynamic Repeated Capabilities for detailed information on using this function.

Physical names list

Use the Add, Remove, and Edit buttons to manage the list of physical names to associate with the repeated capability. The names entered here represent the static repeated capability instances -- that is, they will be available irrespective of what is discovered about the connected instrument at runtime. The names added here will be registered with the IVI Configuration Store by the driver installer.

Tip
Use '-' to specify a range of physical names. For example, entering Channel(1-3) is equivalent to creating three separate entries: Channel1, Channel2, and Channel3. The range must follow the base name and be enclosed in parentheses. The beginning value in the range must be smaller than the end value.

Tip
To modify the list of physical names after running the wizard, double-click the Driver Settings Editor node in Solution Explorer and choose the Repeated Capabilities tab from Driver Settings Editor, editor that appears.

Other Resources