add

Добавьте запись в IVI строение объект хранилища

Синтаксис

add(obj, 'type', 'name', ...)
add(obj, 'DriverSession', 'name', 'ModuleName', 'HardwareAssetName', 'P1', V1)
add(obj, 'HardwareAsset', 'name', 'IOResourceDescriptor', 'P1', V1)
add(obj, 'LogicalName', 'name', 'SessionName', 'P1', V1)
add(obj, struct)

Аргументы

obj

IVI® объект хранилища строений

'DriverSession'
'HardwareAsset'
'LogicalName'

Тип добавляемой записи

'name'

Имя DriverSession, HardwareAsset, или LogicalName добавляется

'IOResourceDescriptor'

Указывает драйверу, как именно найти устройство, которое представляет этот актив

'ModuleName'

Драйвер прибора IVI или программный модуль

'HardwareAssetName'

Уникальный идентификатор для аппаратного обеспечения

'SessionName'

Уникальный идентификатор для сеанса драйвера актива

'P1'

Первый необязательный параметр для добавленной записи. Могут следовать другие пары значение параметров.

V1

Значение для первого параметра

struct

Структура, определяющая элемент, который будет добавлен; имена полей являются именами параметров ввода

Описание

add(obj, 'type', 'name', ...) добавляет новую запись type к объекту хранилища строений IVI, obj, с именем, name. Если запись типа, type, с именем, name, уже существует ошибка. На основе typeтребуются дополнительные аргументы. type можно HardwareAsset, DriverSession, или LogicalName.

add(obj, 'DriverSession', 'name', 'ModuleName', 'HardwareAssetName', 'P1', V1) добавляет новую запись сеанса драйвера к объекту хранилища строений IVI, obj, с именем, name, используя указанное имя программного модуля, ModuleName и имя аппаратного актива, HardwareAssetName. Могут быть включены необязательные пары значение параметров.

Допустимые параметры для DriverSession перечислены ниже. Значение по умолчанию для параметров включения/выключения off.

Параметр

Значение

Описание

Description

Любой вектор символов

Описание сеанса драйвера

VirtualNames

структура

Массив структур, содержащий отображения виртуальных имен

Cache

on/ off

Включите кэширование, если драйвер поддерживает его.

DriverSetup

Любой вектор символов

Это значение зависит от программного модуля

InterchangeCheck

on/ off

Включите проверку взаимозаменяемости драйвера, если она поддерживается

QueryInstrStatus

on/ off

Включите запрос состояния прибора драйвером

RangeCheck

on/ off

Включите проверку расширенной области значений драйвером, если поддерживается

RecordCoercions

on/ off

Включить запись принуждения драйвером, если поддерживается

Simulate

on/ off

Включите симуляцию драйвером

add(obj, 'HardwareAsset', 'name', 'IOResourceDescriptor', 'P1', V1) добавляет новую запись аппаратных средств к объекту хранилища строений IVI, obj, с именем, name, и дескриптор ресурса, IOResourceDescriptor. Могут быть включены необязательные пары значение параметров.

Допустимые параметры для HardwareAsset являются

Параметр

Значение

Описание

Description

Любой вектор символов

Описание оборудования актива

add(obj, 'LogicalName', 'name', 'SessionName', 'P1', V1) добавляет новую логическую запись имени к объекту хранилища строений IVI, obj, с именем, name, и имя сеанса драйвера, SessionName. Могут быть включены необязательные пары значение параметров.

Допустимые параметры для LogicalName являются

Параметр

Значение

Описание

Description

Любой вектор символов

Описание логического имени

add(obj, struct), где struct - структура, имена полей которой являются именами параметров входа, добавляет запись к объекту хранилища строений IVI, obj, заданного типа со значениями, содержащимися в структуре.

Сложения, выполненная к объекту хранилища строения, obj, может быть сохранен в файл данных хранилища строений с commit функция.

Примечание

Чтобы получить список опций, которые можно использовать для функции, нажмите клавишу Tab после ввода функции на MATLAB® командная строка. Список расширяется, и можно прокрутить, чтобы выбрать свойство или значение. Для получения информации об использовании этой расширенной функции заполнения клавишей Tab, смотрите Использование заполнения клавишей Tab для функций.

Примеры

Создайте объект хранилища строений IVI, c.

c = iviconfigurationstore;

Добавьте оборудования актив с именем gpib1, и описание ресурса GPIB0::1::INSTR.

add(c, 'HardwareAsset', 'gpib1', 'GPIB0::1::INSTR');

Добавьте сеанс драйвера с именем S1, который использует программный модуль TekScope и аппаратный актив с именем gpib1.

add(c, 'DriverSession', 'S1', 'TekScope', 'gpib1');

Добавьте логическое имя к объекту хранилища строений c, с именем MyScope, имя сеанса драйвера S1, и описание A logical name.

add(c, 'LogicalName', 'MyScope', 'S1', ...
'Description', 'A logical name');

Добавьте оборудования актив с именем gpib3, и описание ресурса GPIB0::3::ISNTR.

s.Type = 'HardwareAsset';
s.Name = 'gpib3';
s.IOResourceDescriptor = 'GPIB0::3::INSTR';
add(c, s);

Сохраните изменения в IVI строении сохраните файл данных.

commit(c);
Представлено до R2006a