Работа с RshUniDriver в среде LabVIEW

Оглавление

• Типы данных
  • RshChannel.ctl
  • RshInitDAC.ctl
  • RshInitDMA.ctl
  • RshInitMemory.ctl
  • RshInitPort.ctl
  • RshSynchroChannel.ctl
• Перечисления
  • RshCapsCodes.ctl
  • RshDMAMode.ctl
  • RshGetCodes.ctl
  • RshStartTypes.ctl
• Управление устройством
  • GetDeviceHandle.vi
  • CloseDeviceHandle.vi
  • Connect.vi
  • Start.vi
  • Stop.vi
  • IsCapable.vi
• Вспомогательные функции
  • GetErrorString.vi
  • ErrorConverter.vi
• RshDevice::Init() - инициализация устройства
  • InitDAC.vi
  • InitDMA.vi
  • InitMemory.vi
  • InitPort.vi
• IRshDevice::Get() - получение массивов
  • GetArrayChar.vi
  • GetArrayDouble.vi
  • GetArrayInt.vi
  • GetArrayShort.vi
  • GetArrayUnsignedChar.vi
  • GetArrayUnsignedInt.vi
  • GetArrayUnsignedShort.vi
• IRshDevice::Get()
  • GetDouble.vi
  • GetChar.vi
  • GetUnsignedChar.vi
  • GetShort.vi
  • GetUnsignedShort.vi
  • GetInt.vi
  • GetUnsignedInt.vi
  • GetCString.vi
• IRshDevice::GetData - получение данных
  • GetDataChar.vi
  • GetDataDouble.vi
  • GetDataShort.vi
  • GetDataInt.vi
• Конструкторы
  • RshChannelParams.vi
  • RshControlDMAParams.vi
  • RshControlMemoryParams.vi
  • RshControlSynchroParams.vi
  • RshSynchroChannelParams.vi

Типы данных

Различные структуры данных, используемые для управления устройствами и передачи параметров.

RshChannel.ctl

Параметры аналогового канала. Данный кластер используется для задания параметров измерительных каналов в структурах инициализации.

---

RshInitDAC.ctl

Структура инициализации для управления ЦАПами. LabVIEW аналог (кластер) структуры инициализации URshInitDAC.

---

RshInitDMA.ctl

Структура инициализации DMA. LabVIEW аналог (кластер) структуры инициализации URshInitDMA.

---

RshInitMemory.ctl

Структура инициализации Memory. LabVIEW аналог (кластер) структуры инициализации URshInitMemory.

---

RshInitPort.ctl

Структура инициализации для управления цифровым портом устройства. LabVIEW аналог (кластер) структуры инициализации URshInitPort.

---

RshSynchroChannel.ctl

Параметры входа внешней синхроназиции. Данный кластер используется для задания параметров входа внешней синхронизации в структуре инициализации Memory.

---

Перечисления

Списки констант, использующихся при вызове различных функций.

RshCapsCodes.ctl

Список капс-кодов (возможности устройства и базовой библиотеки, см RSH_CAPS)

---

RshDMAMode.ctl

Режимы работы для ДМА устройств (непрерывный сбор данных или режим "Старт-Стоп")

---

RshGetCodes.ctl

Список Get-кодов. Используются для получения различной информации об устройстве и библиотеке абстракции. См. RSH_GET.

Коды из данного списка передаются в качестве параметров в функции Get:

• GetUnsignedInt.vi

---

RshStartTypes.ctl

Список вариантов запуска сбора данных (или генерации сигнала). Аналог перечисления URshStart.

---

Управление устройством

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

GetDeviceHandle.vi

Получение идентификатора драйвера

Параметры VI:

Параметр	Тип	Описание
deviceName		Строка с названием устройства (имя ветки в реестре).
error in (no error)		Контроль ошибок (вход)
function return		Возвращаемое значение - RSH_API_SUCCESS или код ошибки.
deviceHandle out		Полученный идентификатор драйвера устройства (используется для обращения к устройству при вызове всех остальных VI).
error out		Контроль ошибок (выход)

Описание функции:

Аргументы

[in]	deviceName	Строка с названием устройства (имя ветки в реестре).
[in,out]	deviceHandle	Указатель на переменную, в которую будет помещен идентификатор драйвера.

Возвращает

RSH_API_SUCCESS или код ошибки.

Данная фукнция используется для получения идентификатора драйвера, который в дальнейшем используется для управления устройством. Все остальные функции библиотеки RshUniDriver (такие как UniDriverConnect(), UniDriverStart(), UniDriverGetData() и т.д.) требуют идентификатор драйвера в качестве параметра.
При вызове данной функции внутри библиотеки RshUniDriver.dll происходит загрузка объекта с интерфейсом устройства IRshDevice из соответствующей библиотеки абстракции (например, LA20USB.dll). Полученный объект хранится в памяти до выгрузки библиотеки RshUniDriver или до вызова функции UniDriverCloseDeviceHandle(), а его идентификатор возвращается в переменной deviceHandle.

Сигнатура функции из RshUniDriver.dll:

unsigned __stdcall UniDriverGetDeviceHandle(char* deviceName,unsigned int* deviceHandle);

---

CloseDeviceHandle.vi

Освобождение драйвера устройства

Параметры VI:

Параметр	Тип	Описание
error in (no error)		Контроль ошибок (вход)
deviceHandle		Идентификатор драйвера устройства, полученный в результате вызова модуля GetDeviceHandle.vi
function return		Возвращаемое значение - RSH_API_SUCCESS или код ошибки.
deviceHandle out		Идентификатор драйвера устройства, полученный в результате вызова модуля GetDeviceHandle.vi (выход). Значение данного параметра не меняется в процессе выполнения, и нужно только для контроля за потоком выполнения программы в LabVIEW (последовательность вызова VI).
error out		Контроль ошибок (выход)

Описание функции:

Аргументы

[in,out]

deviceHandle

Идентификатор драйвера устройства, полученный в результате вызова функции UniDriverGetDeviceHandle()

Возвращает

RSH_API_SUCCESS или код ошибки.

Данная функция используется для освобождения ресурсов, связанных с загруженной библиотекой абстракции устройства. Как правило, данную функцию нужно вызывать при выходе из программы, либо когда загруженный драйвер устройства больше не нужен.
Обратите внимание, что после успешного вызова данной функции значение идентификатора deviceHandle уже не действительно, т.к. объект, на который он ссылается, будет удален.

Сигнатура функции из RshUniDriver.dll:

unsigned __stdcall UniDriverCloseDeviceHandle(unsigned int deviceHandle);

---

Connect.vi

Подключение к устройству.

Подключение к устройству

Параметры VI:

Параметр	Тип	Описание
deviceHandle		Идентификатор драйвера устройства, полученный в результате вызова функции GetDeviceHandle.vi
deviceIndex		В зависимости от выбранного режима (параметр mode), данный параметр задает либо порядковый номер устройства в системе, либо заводской номер устройства, к которому нужно подключиться.
mode		Способ индексирования. Если выбран режим RSH_CONNECT_MODE_BASE, в качестве параметра deviceIndex нужно передать базовый адрес устройства. Нумерация начинается с 1. Если выбран режим RSH_CONNECT_MODE_SERIAL_NUMBER, в качестве параметра deviceIndex нужно передать заводской номер устройства.
error in (no error)		Контроль ошибок (вход)
function return		Возвращаемое значение. В случае успеха будет равно RSH_API_SUCCESS.
error out		Контроль ошибок (выход)
deviceHandle out		Идентификатор драйвера устройства, полученный в результате вызова модуля GetDeviceHandle.vi (выход). Значение данного параметра не меняется в процессе выполнения, и нужно только для контроля за потоком выполнения программы в LabVIEW (последовательность вызова VI).

Описание функции:

Аргументы

[in]	deviceHandle	Идентификатор драйвера устройства, полученный в результате вызова функции UniDriverGetDeviceHandle()
[in]	deviceIndex	Идентификатор устройства (базовый адрес либо заводской номер).
[in]	mode	Режим подключения Допустимые варианты: RSH_CONNECT_MODE_BASE или RSH_CONNECT_MODE_SERIAL_NUMBER.

Возвращает

RSH_API_SUCCESS или код ошибки.

С помощью данной функции можно подключиться к выбранному устройству.
В зависимости от параметра mode, идентификатор устройства может быть либо базовым адресом (индексация устройств в системе начинается с 1), либо заводским номером устройства (данный вариант возможен не для всех устройств).
После успешного вызова данной функции будет осуществлено физическое подключение к заданному устройству. По сути, до вызова данной функции все операции выполняются только с программными объектами (библиотекам).

Сигнатура функции из RshUniDriver.dll:

unsigned __stdcall UniDriverConnect(unsigned int deviceHandle, unsigned int deviceIndex, unsigned int mode);

---

Start.vi

Запуск сбора данных (генерации сигнала)

Параметры VI:

Параметр	Тип	Описание
deviceHandle		Идентификатор драйвера устройства, полученный в результате вызова модуля GetDeviceHandle.vi
error in (no error)		Контроль ошибок (вход)
function return		Возвращаемое значение - RSH_API_SUCCESS или код ошибки.
error out		Контроль ошибок (выход)
deviceHandle out		Идентификатор драйвера устройства, полученный в результате вызова модуля GetDeviceHandle.vi (выход). Значение данного параметра не меняется в процессе выполнения, и нужно только для контроля за потоком выполнения программы в LabVIEW (последовательность вызова VI).

Описание функции:

Аргументы

[in]

deviceHandle

Идентификатор драйвера устройства, полученный в результате вызова функции UniDriverGetDeviceHandle()

Возвращает

RSH_API_SUCCESS или код ошибки.

Вызов данной функции запускает сбор данных, либо генерацию сигнала в случае генераторов.

Сигнатура функции из RshUniDriver.dll:

unsigned __stdcall UniDriverStart(unsigned int deviceHandle);

---

Stop.vi

Остановка сбора данных (генерации сигнала)

Параметры VI:

Параметр	Тип	Описание
deviceHandle		Идентификатор драйвера устройства, полученный в результате вызова модуля GetDeviceHandle.vi
error in (no error)		Контроль ошибок (вход)
function return		Возвращаемое значение - RSH_API_SUCCESS или код ошибки.
error out		Контроль ошибок (выход)
deviceHandle out		Идентификатор драйвера устройства, полученный в результате вызова модуля GetDeviceHandle.vi (выход). Значение данного параметра не меняется в процессе выполнения, и нужно только для контроля за потоком выполнения программы в LabVIEW (последовательность вызова VI).

Описание функции:

Аргументы

[in]

deviceHandle

Идентификатор драйвера устройства, полученный в результате вызова функции UniDriverGetDeviceHandle()

Возвращает

RSH_API_SUCCESS или код ошибки.

Вызов данной функции останавливает сбор данных, либо генерацию сигнала в случае генераторов.

Сигнатура функции из RshUniDriver.dll:

unsigned __stdcall UniDriverStop(unsigned int deviceHandle);

---

IsCapable.vi

Проверка возможностей устройства и библиотеки

Параметры VI:

Параметр	Тип	Описание
deviceHandle		Идентификатор драйвера устройства, полученный в результате вызова модуля GetDeviceHandle.vi
error in (no error)		Контроль ошибок (вход)
capsCode		CAPS-код. Одна из констант перечисления RSH_CAPS.
error out		Контроль ошибок (выход)
deviceHandle out		Идентификатор драйвера устройства, полученный в результате вызова модуля GetDeviceHandle.vi (выход). Значение данного параметра не меняется в процессе выполнения, и нужно только для контроля за потоком выполнения программы в LabVIEW (последовательность вызова VI).
Capable		Результат проверки: если TRUE, код поддерживается, если FALSE - нет.

Описание функции:

Аргументы

[in]	deviceHandle	Идентификатор драйвера устройства, полученный в результате вызова функции UniDriverGetDeviceHandle()
[in]	capsCode	Одна из констант перечисления RSH_CAPS

Возвращает

RSH_API_SUCCESS или код ошибки.

С помощью данной функции можно проверить поддержку устройством различных аппаратных и программных возможностей, режимов работы и прочего. Подробности - в описании RSH_CAPS.
Если функция возвращает код RSH_API_SUCCESS - значит запрашиваемая возможность поддерживается устройством.

Сигнатура функции из RshUniDriver.dll:

unsigned __stdcall UniDriverIsCapable(unsigned int deviceHandle, unsigned int capsCode); 

---

Вспомогательные функции

GetErrorString.vi

Получение строки с описанием ошибки

Параметры VI:

Параметр	Тип	Описание
error		Код ошибки, полученный в результате вызова одной из функций RSH_API.
language		Язык - одна из констант перечисления RSH_LANGUAGE
error in (no error)		Контроль ошибок (вход)
function return		Возвращаемое значение - RSH_API_SUCCESS или код ошибки.
description out		Результат выполнения функции: строка с описанием ошибки
error out		Контроль ошибок (выход)

Описание функции:

Аргументы

[in]	error	Код ошибки, полученный в результате вызова одной из функций RshUniDriver
[in,out]	description	Указатель на массив (строку) типа char*, в который будут скопированы данные (строка с описанием ошибки).
[in]	maxLength	Максимальный размер строки (должен быть равен размеру выделенной памяти в буфере description).
[in]	language	Язык описания (одна из констант - RSH_LANGUAGE_ENGLISH или RSH_LANGUAGE_RUSSIAN)

Возвращает

RSH_API_SUCCESS или код ошибки.

Данная функция позволяет получить строку с описанием ошибки по ее коду.
Эта функция - аналог функции UniDriverGetError(), но для передачи строки не используется специальная структура.
Пример использования:

char errorDesc[1024];  
UniDriverLVGetError(code, errorDesc,1024,RSH_LANGUAGE_ENGLISH);
printf("Function failed with error:\n[0x%08X] - %s", code,  errorDesc);  

Предупреждения

Память под данные должна быть выделена заранее, в программе пользователя. Внутри библиотеки UniDriver происходит только копирование в переданный буфер.

Сигнатура функции из RshUniDriver.dll:

unsigned __stdcall UniDriverLVGetError(unsigned int error, char* description , int language);

---

ErrorConverter.vi

Данный модуль используется для получения описания ошибки (а точнее, заполнения стандартного кластера контроля ошибок). Переданный код ошибки (полученный в результате выполнения одной из функций) используется для формирования строки с описанием ошибки RSH SDK.

Параметр	Тип	Описание
error code		Код ошибки, полученный в результате выполнения одной из функций RSH SDK.
error in (no error)		Контроль ошибок (вход)
error out		Контроль ошибок (выход)

---

RshDevice::Init() - инициализация устройства

Для передачи параметров инициализации в LabVIEW используется несколько функций, каждая из которых работает с определенной структурой инициализации.

InitDAC.vi

Инициализация устройства с использованием структуры RshInitDAC (кластер RshInitDAC.clb)

Параметры VI:

Параметр	Тип	Описание
deviceHandle		Идентификатор драйвера устройства, полученный в результате вызова модуля GetDeviceHandle.vi
initializationMode		Режим инициализации - одна из констант перечисления RSH_INIT_MODES
error in (no error)		Контроль ошибок (вход)
Initialization structure		Структура инициализации - заполненный кластер RshInitDAC.clb
function return		Возвращаемое значение - RSH_API_SUCCESS или код ошибки.
error out		Контроль ошибок (выход)
deviceHandle out		Идентификатор драйвера устройства, полученный в результате вызова модуля GetDeviceHandle.vi (выход). Значение данного параметра не меняется в процессе выполнения, и нужно только для контроля за потоком выполнения программы в LabVIEW (последовательность вызова VI).
Initialization structure out		Структура инициализации (выход). Значения параметров могут быть откорректированы в процессе инициализации!

Данная функция используется для управления ЦАПами.

---

InitDMA.vi

Инициализация устройства с использованием структуры RshInitDMA (кластер RshInitDMA.clb)

Параметры VI:

Параметр	Тип	Описание
deviceHandle		Идентификатор драйвера устройства, полученный в результате вызова модуля GetDeviceHandle.vi
initializationMode		Режим инициализации - одна из констант перечисления RSH_INIT_MODES
error in (no error)		Контроль ошибок (вход)
Initialization structure		Структура инициализации - заполненный кластер RshInitDMA.clb
function return		Возвращаемое значение - RSH_API_SUCCESS или код ошибки.
error out		Контроль ошибок (выход)
deviceHandle out		Идентификатор драйвера устройства, полученный в результате вызова модуля GetDeviceHandle.vi (выход). Значение данного параметра не меняется в процессе выполнения, и нужно только для контроля за потоком выполнения программы в LabVIEW (последовательность вызова VI).
Initialization structure out		Структура инициализации (выход). Значения параметров могут быть откорректированы в процессе инициализации!

Данная функция используется для инициализации устройства с использованием структуры инициализации RshInitDMA.clb

---

InitMemory.vi

Инициализация устройства с использованием структуры RshInitMemory (кластер RshInitMemory.clb)

Параметры VI:

Параметр	Тип	Описание
deviceHandle		Идентификатор драйвера устройства, полученный в результате вызова модуля GetDeviceHandle.vi
initializationMode		Режим инициализации - одна из констант перечисления RSH_INIT_MODES
error in (no error)		Контроль ошибок (вход)
Initialization structure		Структура инициализации - заполненный кластер RshInitMemory.clb
function return		Возвращаемое значение - RSH_API_SUCCESS или код ошибки.
error out		Контроль ошибок (выход)
deviceHandle out		Идентификатор драйвера устройства, полученный в результате вызова модуля GetDeviceHandle.vi (выход). Значение данного параметра не меняется в процессе выполнения, и нужно только для контроля за потоком выполнения программы в LabVIEW (последовательность вызова VI).
Initialization structure out		Структура инициализации (выход). Значения параметров могут быть откорректированы в процессе инициализации!

Данная функция используется для инициализации устройства с использованием структуры инициализации RshInitMemory.clb

---

InitPort.vi

Инициализация устройства с использованием структуры RshInitPort (кластер RshInitPort.clb)

Параметры VI:

Параметр	Тип	Описание
deviceHandle		Идентификатор драйвера устройства, полученный в результате вызова модуля GetDeviceHandle.vi
initializationMode		Режим инициализации - одна из констант перечисления RSH_INIT_MODES
error in (no error)		Контроль ошибок (вход)
Initialization structure		Структура инициализации - заполненный кластер RshInitPort.clb
function return		Возвращаемое значение - RSH_API_SUCCESS или код ошибки.
error out		Контроль ошибок (выход)
deviceHandle out		Идентификатор драйвера устройства, полученный в результате вызова модуля GetDeviceHandle.vi (выход). Значение данного параметра не меняется в процессе выполнения, и нужно только для контроля за потоком выполнения программы в LabVIEW (последовательность вызова VI).
Initialization structure out		Структура инициализации (выход). Значения параметров могут быть откорректированы в процессе инициализации!

Данная функция используется для управления цифровыми портами устройства (структура инициализации RshInitPort.clb)

---

IRshDevice::Get() - получение массивов

Для получения информации в виде массивов (например, список коэффициентов усиления, частот и т.п.) в библиотеке RshUniDriver используются функции, которые, по сути, являются оберткой метода IRshDevice::Get(). Данные функции используются для получения массивов определенного типа.

GetArrayChar.vi

Получение информации об устройстве или библиотеке (char* - массив).

Параметры VI:

Параметр	Тип	Описание
deviceHandle		Идентификатор драйвера устройства, полученный в результате вызова модуля GetDeviceHandle.vi
size		Размер массива - максимальное количество элементов, которые можно скопировать в массив.
error in (no error)		Контроль ошибок (вход)
mode		Одна из констант перечисления RSH_GET. Для данного VI подходят константы, в описании которых указан тип данных RSH_BUFFER_S8
data in		Массив, в который будут помещены данные
function return		Возвращаемое значение - RSH_API_SUCCESS или код ошибки.
error out		Контроль ошибок (выход)
data out		Заполненный данными (выходной) массив
deviceHandle out		Идентификатор драйвера устройства, полученный в результате вызова модуля GetDeviceHandle.vi (выход). Значение данного параметра не меняется в процессе выполнения, и нужно только для контроля за потоком выполнения программы в LabVIEW (последовательность вызова VI).

Описание функции:

Аргументы

[in]	deviceHandle	Идентификатор драйвера устройства, полученный в результате вызова функции UniDriverGetDeviceHandle()
[in]	mode	Одна из констант перечисления RSH_GET
[in]	size	Размер массива - максимальное количество элементов, которые можно скопировать в массив, указатель на который передается в параметре data.
[in,out]	received	После успешного выполнения функции в даннной переменной будет возвращено количество фактически скопированных элементов.
[in,out]	data	Указатель на массив, в который будут скопированы данные

Возвращает

RSH_API_SUCCESS или код ошибки.

Данная функция - аналог функции UniDriverGet(). Отличие в том, что для передачи данных не используется специальная структура данных - можно просто передать указатель на массив нужного типа.
Тип данных, указанный в описании Get-кода, который подходит для данной функции: RSH_BUFFER_S8

Предупреждения

Память под данные должна быть выделена заранее, в программе пользователя. Внутри библиотеки UniDriver происходит только копирование в переданный буфер.

Сигнатура функции из RshUniDriver.dll:

unsigned __stdcall UniDriverLVGetArrayChar(unsigned int deviceHandle, unsigned int mode, unsigned int size, unsigned int* received, char* data);

---

GetArrayDouble.vi

Получение информации об устройстве или библиотеке (double* - массив).

Параметры VI:

Параметр	Тип	Описание
deviceHandle		Идентификатор драйвера устройства, полученный в результате вызова модуля GetDeviceHandle.vi
size		Размер массива - максимальное количество элементов, которые можно скопировать в массив.
error in (no error)		Контроль ошибок (вход)
mode		Одна из констант перечисления RSH_GET. Для данного VI подходят константы, в описании которых указан тип данных RSH_BUFFER_DOUBLE
data in		Массив, в который будут помещены данные
function return		Возвращаемое значение - RSH_API_SUCCESS или код ошибки.
error out		Контроль ошибок (выход)
data out		Заполненный данными (выходной) массив
deviceHandle out		Идентификатор драйвера устройства, полученный в результате вызова модуля GetDeviceHandle.vi (выход). Значение данного параметра не меняется в процессе выполнения, и нужно только для контроля за потоком выполнения программы в LabVIEW (последовательность вызова VI).

Описание функции:

Аргументы

[in]	deviceHandle	Идентификатор драйвера устройства, полученный в результате вызова функции UniDriverGetDeviceHandle()
[in]	mode	Одна из констант перечисления RSH_GET
[in]	size	Размер массива - максимальное количество элементов, которые можно скопировать в массив, указатель на который передается в параметре data.
[in,out]	received	После успешного выполнения функции в даннной переменной будет возвращено количество фактически скопированных элементов.
[in,out]	data	Указатель на массив, в который будут скопированы данные

Возвращает

RSH_API_SUCCESS или код ошибки.

Данная функция - аналог функции UniDriverGet(). Отличие в том, что для передачи данных не используется специальная структура данных - можно просто передать указатель на массив нужного типа.
Тип данных, указанный в описании Get-кода, который подходит для данной функции: RSH_BUFFER_DOUBLE

Предупреждения

Память под данные должна быть выделена заранее, в программе пользователя. Внутри библиотеки UniDriver происходит только копирование в переданный буфер.

Сигнатура функции из RshUniDriver.dll:

unsigned __stdcall UniDriverLVGetArrayDouble(unsigned int deviceHandle, unsigned int mode, unsigned int size, unsigned int* received, double* data);

---

GetArrayInt.vi

Получение информации об устройстве или библиотеке (int* - массив).

Параметры VI:

Параметр	Тип	Описание
deviceHandle		Идентификатор драйвера устройства, полученный в результате вызова модуля GetDeviceHandle.vi
size		Размер массива - максимальное количество элементов, которые можно скопировать в массив.
error in (no error)		Контроль ошибок (вход)
mode		Одна из констант перечисления RSH_GET. Для данного VI подходят константы, в описании которых указан тип данных RSH_BUFFER_S32
data in		Массив, в который будут помещены данные
function return		Возвращаемое значение - RSH_API_SUCCESS или код ошибки.
error out		Контроль ошибок (выход)
data out		Заполненный данными (выходной) массив
deviceHandle out		Идентификатор драйвера устройства, полученный в результате вызова модуля GetDeviceHandle.vi (выход). Значение данного параметра не меняется в процессе выполнения, и нужно только для контроля за потоком выполнения программы в LabVIEW (последовательность вызова VI).

Описание функции:

Аргументы

[in]	deviceHandle	Идентификатор драйвера устройства, полученный в результате вызова функции UniDriverGetDeviceHandle()
[in]	mode	Одна из констант перечисления RSH_GET
[in]	size	Размер массива - максимальное количество элементов, которые можно скопировать в массив, указатель на который передается в параметре data.
[in,out]	received	После успешного выполнения функции в даннной переменной будет возвращено количество фактически скопированных элементов.
[in,out]	data	Указатель на массив, в который будут скопированы данные

Возвращает

RSH_API_SUCCESS или код ошибки.

Данная функция - аналог функции UniDriverGet(). Отличие в том, что для передачи данных не используется специальная структура данных - можно просто передать указатель на массив нужного типа.
Тип данных, указанный в описании Get-кода, который подходит для данной функции: RSH_BUFFER_S32

Предупреждения

Память под данные должна быть выделена заранее, в программе пользователя. Внутри библиотеки UniDriver происходит только копирование в переданный буфер.

Сигнатура функции из RshUniDriver.dll:

unsigned __stdcall UniDriverLVGetArrayInt(unsigned int deviceHandle, unsigned int mode, unsigned int size, unsigned int* received, int* data);

---

GetArrayShort.vi

Получение информации об устройстве или библиотеке (short* - массив).

Параметры VI:

Параметр	Тип	Описание
deviceHandle		Идентификатор драйвера устройства, полученный в результате вызова модуля GetDeviceHandle.vi
size		Размер массива - максимальное количество элементов, которые можно скопировать в массив.
error in (no error)		Контроль ошибок (вход)
mode		Одна из констант перечисления RSH_GET. Для данного VI подходят константы, в описании которых указан тип данных RSH_BUFFER_S16
data in		Массив, в который будут помещены данные
function return		Возвращаемое значение - RSH_API_SUCCESS или код ошибки.
error out		Контроль ошибок (выход)
data out		Заполненный данными (выходной) массив
deviceHandle out		Идентификатор драйвера устройства, полученный в результате вызова модуля GetDeviceHandle.vi (выход). Значение данного параметра не меняется в процессе выполнения, и нужно только для контроля за потоком выполнения программы в LabVIEW (последовательность вызова VI).

Описание функции:

Аргументы

[in]	deviceHandle	Идентификатор драйвера устройства, полученный в результате вызова функции UniDriverGetDeviceHandle()
[in]	mode	Одна из констант перечисления RSH_GET
[in]	size	Размер массива - максимальное количество элементов, которые можно скопировать в массив, указатель на который передается в параметре data.
[in,out]	received	После успешного выполнения функции в даннной переменной будет возвращено количество фактически скопированных элементов.
[in,out]	data	Указатель на массив, в который будут скопированы данные

Возвращает

RSH_API_SUCCESS или код ошибки.

Данная функция - аналог функции UniDriverGet(). Отличие в том, что для передачи данных не используется специальная структура данных - можно просто передать указатель на массив нужного типа.
Тип данных, указанный в описании Get-кода, который подходит для данной функции: RSH_BUFFER_S16

Предупреждения

Память под данные должна быть выделена заранее, в программе пользователя. Внутри библиотеки UniDriver происходит только копирование в переданный буфер.

Сигнатура функции из RshUniDriver.dll:

unsigned __stdcall UniDriverLVGetArrayShort(unsigned int deviceHandle, unsigned int mode,unsigned int size, unsigned int* received, short* data);

---

GetArrayUnsignedChar.vi

Получение информации об устройстве или библиотеке (unsigned char* - массив).

Параметры VI:

Параметр	Тип	Описание
deviceHandle		Идентификатор драйвера устройства, полученный в результате вызова модуля GetDeviceHandle.vi
size		Размер массива - максимальное количество элементов, которые можно скопировать в массив.
error in (no error)		Контроль ошибок (вход)
mode		Одна из констант перечисления RSH_GET. Для данного VI подходят константы, в описании которых указан тип данных RSH_BUFFER_U8
data in		Массив, в который будут помещены данные
function return		Возвращаемое значение - RSH_API_SUCCESS или код ошибки.
error out		Контроль ошибок (выход)
data out		Заполненный данными (выходной) массив
deviceHandle out		Идентификатор драйвера устройства, полученный в результате вызова модуля GetDeviceHandle.vi (выход). Значение данного параметра не меняется в процессе выполнения, и нужно только для контроля за потоком выполнения программы в LabVIEW (последовательность вызова VI).

Описание функции:

Аргументы

[in]	deviceHandle	Идентификатор драйвера устройства, полученный в результате вызова функции UniDriverGetDeviceHandle()
[in]	mode	Одна из констант перечисления RSH_GET
[in]	size	Размер массива - максимальное количество элементов, которые можно скопировать в массив, указатель на который передается в параметре data.
[in,out]	received	После успешного выполнения функции в даннной переменной будет возвращено количество фактически скопированных элементов.
[in,out]	data	Указатель на массив, в который будут скопированы данные

Возвращает

RSH_API_SUCCESS или код ошибки.

Данная функция - аналог функции UniDriverGet(). Отличие в том, что для передачи данных не используется специальная структура данных - можно просто передать указатель на массив нужного типа.
Тип данных, указанный в описании Get-кода, который подходит для данной функции: RSH_BUFFER_U8

Предупреждения

Память под данные должна быть выделена заранее, в программе пользователя. Внутри библиотеки UniDriver происходит только копирование в переданный буфер.

Сигнатура функции из RshUniDriver.dll:

unsigned __stdcall UniDriverLVGetArrayUChar(unsigned int deviceHandle, unsigned int mode, unsigned int size, unsigned int* received, unsigned char* data);

---

GetArrayUnsignedInt.vi

Получение информации об устройстве или библиотеке (unsigned int* - массив).

Параметры VI:

Параметр	Тип	Описание
deviceHandle		Идентификатор драйвера устройства, полученный в результате вызова модуля GetDeviceHandle.vi
size		Размер массива - максимальное количество элементов, которые можно скопировать в массив.
error in (no error)		Контроль ошибок (вход)
mode		Одна из констант перечисления RSH_GET. Для данного VI подходят константы, в описании которых указан тип данных RSH_BUFFER_U32
data in		Массив, в который будут помещены данные
function return		Возвращаемое значение - RSH_API_SUCCESS или код ошибки.
error out		Контроль ошибок (выход)
data out		Заполненный данными (выходной) массив
deviceHandle out		Идентификатор драйвера устройства, полученный в результате вызова модуля GetDeviceHandle.vi (выход). Значение данного параметра не меняется в процессе выполнения, и нужно только для контроля за потоком выполнения программы в LabVIEW (последовательность вызова VI).

Описание функции:

Аргументы

[in]	deviceHandle	Идентификатор драйвера устройства, полученный в результате вызова функции UniDriverGetDeviceHandle()
[in]	mode	Одна из констант перечисления RSH_GET
[in]	size	Размер массива - максимальное количество элементов, которые можно скопировать в массив, указатель на который передается в параметре data.
[in,out]	received	После успешного выполнения функции в даннной переменной будет возвращено количество фактически скопированных элементов.
[in,out]	data	Указатель на массив, в который будут скопированы данные

Возвращает

RSH_API_SUCCESS или код ошибки.

Данная функция - аналог функции UniDriverGet(). Отличие в том, что для передачи данных не используется специальная структура данных - можно просто передать указатель на массив нужного типа.
Тип данных, указанный в описании Get-кода, который подходит для данной функции: RSH_BUFFER_U32

Предупреждения

Память под данные должна быть выделена заранее, в программе пользователя. Внутри библиотеки UniDriver происходит только копирование в переданный буфер.

Сигнатура функции из RshUniDriver.dll:

unsigned __stdcall UniDriverLVGetArrayUInt(unsigned int deviceHandle, unsigned int mode, unsigned int size, unsigned int* received, unsigned int* data);

---

GetArrayUnsignedShort.vi

Получение информации об устройстве или библиотеке (unsigned short* - массив).

Параметры VI:

Параметр	Тип	Описание
deviceHandle		Идентификатор драйвера устройства, полученный в результате вызова модуля GetDeviceHandle.vi
size		Размер массива - максимальное количество элементов, которые можно скопировать в массив.
error in (no error)		Контроль ошибок (вход)
mode		Одна из констант перечисления RSH_GET. Для данного VI подходят константы, в описании которых указан тип данных RSH_BUFFER_U16
data in		Массив, в который будут помещены данные
function return		Возвращаемое значение - RSH_API_SUCCESS или код ошибки.
error out		Контроль ошибок (выход)
data out		Заполненный данными (выходной) массив
deviceHandle out		Идентификатор драйвера устройства, полученный в результате вызова модуля GetDeviceHandle.vi (выход). Значение данного параметра не меняется в процессе выполнения, и нужно только для контроля за потоком выполнения программы в LabVIEW (последовательность вызова VI).

Описание функции:

Аргументы

[in]	deviceHandle	Идентификатор драйвера устройства, полученный в результате вызова функции UniDriverGetDeviceHandle()
[in]	mode	Одна из констант перечисления RSH_GET
[in]	size	Размер массива - максимальное количество элементов, которые можно скопировать в массив, указатель на который передается в параметре data.
[in,out]	received	После успешного выполнения функции в даннной переменной будет возвращено количество фактически скопированных элементов.
[in,out]	data	Указатель на массив, в который будут скопированы данные

Возвращает

RSH_API_SUCCESS или код ошибки.

Данная функция - аналог функции UniDriverGet(). Отличие в том, что для передачи данных не используется специальная структура данных - можно просто передать указатель на массив нужного типа.
Тип данных, указанный в описании Get-кода, который подходит для данной функции: RSH_BUFFER_U16

Предупреждения

Память под данные должна быть выделена заранее, в программе пользователя. Внутри библиотеки UniDriver происходит только копирование в переданный буфер.

Сигнатура функции из RshUniDriver.dll:

unsigned __stdcall UniDriverLVGetArrayUShort(unsigned int deviceHandle, unsigned int mode, unsigned int size, unsigned int* received, unsigned short* data);

---

IRshDevice::Get()

Для получения данных (информации) об устройстве и библиотеке абстракции в библиотеке RshUniDriver.dll используется ряд функций, которые являются аналогами метода IRshDevice::Get(), но при этом жестко типизированы.

GetDouble.vi

Получение информации об устройстве или библиотеке (double).

Параметры VI:

Параметр	Тип	Описание
deviceHandle		Идентификатор драйвера устройства, полученный в результате вызова модуля GetDeviceHandle.vi
error in (no error)		Контроль ошибок (вход)
mode		Одна из констант перечисления RSH_GET. Для данного VI подходят константы, в описании которых указан тип данных RSH_DOUBLE
value in		Входные данные. Иногда нужно передать какое-либо значение в библиотеку абстракции, а не прочитать его. В этом случае нужно задать значение, иначе данный параметр можно игнорировать.
function return		Возвращаемое значение - RSH_API_SUCCESS или код ошибки.
error out		Контроль ошибок (выход)
value out		Выходные данные. Полученное в результате выполнения функции значение.
deviceHandle out		Идентификатор драйвера устройства, полученный в результате вызова модуля GetDeviceHandle.vi (выход). Значение данного параметра не меняется в процессе выполнения, и нужно только для контроля за потоком выполнения программы в LabVIEW (последовательность вызова VI).

Описание функции:

Аргументы

[in]	deviceHandle	Идентификатор драйвера устройства, полученный в результате вызова функции UniDriverGetDeviceHandle()
[in]	mode	Одна из констант перечисления RSH_GET
[in,out]	value	Указатель на переменную, в которую будут помещены данные.

Возвращает

RSH_API_SUCCESS или код ошибки.

Данная функция - аналог функции UniDriverGet(). Отличие в том, что для передачи данных не используется специальная структура данных - можно просто передать указатель на переменную нужного типа.
Тип данных, указанный в описании Get-кода, который подходит для данной функции: RSH_DOUBLE

Предупреждения

Память под данные должна быть выделена заранее, в программе пользователя.

Сигнатура функции из RshUniDriver.dll:

unsigned __stdcall UniDriverLVGetDouble(unsigned int deviceHandle, unsigned int mode, double* value);

---

GetChar.vi

Получение информации об устройстве или библиотеке (char).

Параметры VI:

Параметр	Тип	Описание
deviceHandle		Идентификатор драйвера устройства, полученный в результате вызова модуля GetDeviceHandle.vi
error in (no error)		Контроль ошибок (вход)
mode		Одна из констант перечисления RSH_GET. Для данного VI подходят константы, в описании которых указан тип данных RSH_S8
value in		Входные данные. Иногда нужно передать какое-либо значение в библиотеку абстракции, а не прочитать его. В этом случае нужно задать значение, иначе данный параметр можно игнорировать.
function return		Возвращаемое значение - RSH_API_SUCCESS или код ошибки.
error out		Контроль ошибок (выход)
value out		Выходные данные. Полученное в результате выполнения функции значение.
deviceHandle out		Идентификатор драйвера устройства, полученный в результате вызова модуля GetDeviceHandle.vi (выход). Значение данного параметра не меняется в процессе выполнения, и нужно только для контроля за потоком выполнения программы в LabVIEW (последовательность вызова VI).

Описание функции:

Аргументы

[in]	deviceHandle	Идентификатор драйвера устройства, полученный в результате вызова функции UniDriverGetDeviceHandle()
[in]	mode	Одна из констант перечисления RSH_GET
[in,out]	value	Указатель на переменную, в которую будут помещены данные.

Возвращает

RSH_API_SUCCESS или код ошибки.

Данная функция - аналог функции UniDriverGet(). Отличие в том, что для передачи данных не используется специальная структура данных - можно просто передать указатель на переменную нужного типа.
Тип данных, указанный в описании Get-кода, который подходит для данной функции: RSH_S8

Предупреждения

Память под данные должна быть выделена заранее, в программе пользователя.

Сигнатура функции из RshUniDriver.dll:

unsigned __stdcall UniDriverLVGetChar(unsigned int deviceHandle, unsigned int mode, char* value);

---

GetUnsignedChar.vi

Получение информации об устройстве или библиотеке (unsigned char).

Параметры VI:

Параметр	Тип	Описание
deviceHandle		Идентификатор драйвера устройства, полученный в результате вызова модуля GetDeviceHandle.vi
error in (no error)		Контроль ошибок (вход)
mode		Одна из констант перечисления RSH_GET. Для данного VI подходят константы, в описании которых указан тип данных RSH_U8
value in		Входные данные. Иногда нужно передать какое-либо значение в библиотеку абстракции, а не прочитать его. В этом случае нужно задать значение, иначе данный параметр можно игнорировать.
function return		Возвращаемое значение - RSH_API_SUCCESS или код ошибки.
error out		Контроль ошибок (выход)
value out		Выходные данные. Полученное в результате выполнения функции значение.
deviceHandle out		Идентификатор драйвера устройства, полученный в результате вызова модуля GetDeviceHandle.vi (выход). Значение данного параметра не меняется в процессе выполнения, и нужно только для контроля за потоком выполнения программы в LabVIEW (последовательность вызова VI).

Описание функции:

Аргументы

[in]	deviceHandle	Идентификатор драйвера устройства, полученный в результате вызова функции UniDriverGetDeviceHandle()
[in]	mode	Одна из констант перечисления RSH_GET
[in,out]	value	Указатель на переменную, в которую будут помещены данные.

Возвращает

RSH_API_SUCCESS или код ошибки.

Данная функция - аналог функции UniDriverGet(). Отличие в том, что для передачи данных не используется специальная структура данных - можно просто передать указатель на переменную нужного типа.
Тип данных, указанный в описании Get-кода, который подходит для данной функции: RSH_U8

Предупреждения

Память под данные должна быть выделена заранее, в программе пользователя.

Сигнатура функции из RshUniDriver.dll:

unsigned __stdcall UniDriverLVGetUChar(unsigned int deviceHandle, unsigned int mode,unsigned char* value);

---

GetShort.vi

Получение информации об устройстве или библиотеке (short).

Параметры VI:

Параметр	Тип	Описание
deviceHandle		Идентификатор драйвера устройства, полученный в результате вызова модуля GetDeviceHandle.vi
error in (no error)		Контроль ошибок (вход)
mode		Одна из констант перечисления RSH_GET. Для данного VI подходят константы, в описании которых указан тип данных RSH_S16
value in		Входные данные. Иногда нужно передать какое-либо значение в библиотеку абстракции, а не прочитать его. В этом случае нужно задать значение, иначе данный параметр можно игнорировать.
function return		Возвращаемое значение - RSH_API_SUCCESS или код ошибки.
error out		Контроль ошибок (выход)
value out		Выходные данные. Полученное в результате выполнения функции значение.
deviceHandle out		Идентификатор драйвера устройства, полученный в результате вызова модуля GetDeviceHandle.vi (выход). Значение данного параметра не меняется в процессе выполнения, и нужно только для контроля за потоком выполнения программы в LabVIEW (последовательность вызова VI).

Описание функции:

Аргументы

[in]	deviceHandle	Идентификатор драйвера устройства, полученный в результате вызова функции UniDriverGetDeviceHandle()
[in]	mode	Одна из констант перечисления RSH_GET
[in,out]	value	Указатель на переменную, в которую будут помещены данные.

Возвращает

RSH_API_SUCCESS или код ошибки.

Данная функция - аналог функции UniDriverGet(). Отличие в том, что для передачи данных не используется специальная структура данных - можно просто передать указатель на переменную нужного типа.
Тип данных, указанный в описании Get-кода, который подходит для данной функции: RSH_S16

Предупреждения

Память под данные должна быть выделена заранее, в программе пользователя.

Сигнатура функции из RshUniDriver.dll:

unsigned __stdcall UniDriverLVGetShort(unsigned int deviceHandle, unsigned int mode, short* value);

---

GetUnsignedShort.vi

Получение информации об устройстве или библиотеке (unsigned short).

Параметры VI:

Параметр	Тип	Описание
deviceHandle		Идентификатор драйвера устройства, полученный в результате вызова модуля GetDeviceHandle.vi
error in (no error)		Контроль ошибок (вход)
mode		Одна из констант перечисления RSH_GET. Для данного VI подходят константы, в описании которых указан тип данных RSH_U16
value in		Входные данные. Иногда нужно передать какое-либо значение в библиотеку абстракции, а не прочитать его. В этом случае нужно задать значение, иначе данный параметр можно игнорировать.
function return		Возвращаемое значение - RSH_API_SUCCESS или код ошибки.
error out		Контроль ошибок (выход)
value out		Выходные данные. Полученное в результате выполнения функции значение.
deviceHandle out		Идентификатор драйвера устройства, полученный в результате вызова модуля GetDeviceHandle.vi (выход). Значение данного параметра не меняется в процессе выполнения, и нужно только для контроля за потоком выполнения программы в LabVIEW (последовательность вызова VI).

Описание функции:

Аргументы

[in]	deviceHandle	Идентификатор драйвера устройства, полученный в результате вызова функции UniDriverGetDeviceHandle()
[in]	mode	Одна из констант перечисления RSH_GET
[in,out]	value	Указатель на переменную, в которую будут помещены данные.

Возвращает

RSH_API_SUCCESS или код ошибки.

Данная функция - аналог функции UniDriverGet(). Отличие в том, что для передачи данных не используется специальная структура данных - можно просто передать указатель на переменную нужного типа.
Тип данных, указанный в описании Get-кода, который подходит для данной функции: RSH_U16

Предупреждения

Память под данные должна быть выделена заранее, в программе пользователя.

Сигнатура функции из RshUniDriver.dll:

unsigned __stdcall UniDriverLVGetUShort(unsigned int deviceHandle, unsigned int mode,unsigned short* value);

---

GetInt.vi

Получение информации об устройстве или библиотеке (int).

Параметры VI:

Параметр	Тип	Описание
deviceHandle		Идентификатор драйвера устройства, полученный в результате вызова модуля GetDeviceHandle.vi
error in (no error)		Контроль ошибок (вход)
mode		Одна из констант перечисления RSH_GET. Для данного VI подходят константы, в описании которых указан тип данных RSH_S32
value in		Входные данные. Иногда нужно передать какое-либо значение в библиотеку абстракции, а не прочитать его. В этом случае нужно задать значение, иначе данный параметр можно игнорировать.
function return		Возвращаемое значение - RSH_API_SUCCESS или код ошибки.
error out		Контроль ошибок (выход)
value out		Выходные данные. Полученное в результате выполнения функции значение.
deviceHandle out		Идентификатор драйвера устройства, полученный в результате вызова модуля GetDeviceHandle.vi (выход). Значение данного параметра не меняется в процессе выполнения, и нужно только для контроля за потоком выполнения программы в LabVIEW (последовательность вызова VI).

Описание функции:

Аргументы

[in]	deviceHandle	Идентификатор драйвера устройства, полученный в результате вызова функции UniDriverGetDeviceHandle()
[in]	mode	Одна из констант перечисления RSH_GET
[in,out]	value	Указатель на переменную, в которую будут помещены данные.

Возвращает

RSH_API_SUCCESS или код ошибки.

Данная функция - аналог функции UniDriverGet(). Отличие в том, что для передачи данных не используется специальная структура данных - можно просто передать указатель на переменную нужного типа.
Тип данных, указанный в описании Get-кода, который подходит для данной функции: RSH_S32

Предупреждения

Память под данные должна быть выделена заранее, в программе пользователя.

Сигнатура функции из RshUniDriver.dll:

unsigned __stdcall UniDriverLVGetInt(unsigned int deviceHandle, unsigned int mode, int* value);

---

GetUnsignedInt.vi

Получение информации об устройстве или библиотеке (unsigned int).

Параметры VI:

Параметр	Тип	Описание
deviceHandle		Идентификатор драйвера устройства, полученный в результате вызова модуля GetDeviceHandle.vi
error in (no error)		Контроль ошибок (вход)
mode		Одна из констант перечисления RSH_GET. Для данного VI подходят константы, в описании которых указан тип данных RSH_U32
value in		Входные данные. Иногда нужно передать какое-либо значение в библиотеку абстракции, а не прочитать его. В этом случае нужно задать значение, иначе данный параметр можно игнорировать.
function return		Возвращаемое значение - RSH_API_SUCCESS или код ошибки.
error out		Контроль ошибок (выход)
value out		Выходные данные. Полученное в результате выполнения функции значение.
deviceHandle out		Идентификатор драйвера устройства, полученный в результате вызова модуля GetDeviceHandle.vi (выход). Значение данного параметра не меняется в процессе выполнения, и нужно только для контроля за потоком выполнения программы в LabVIEW (последовательность вызова VI).

Описание функции:

Аргументы

[in]	deviceHandle	Идентификатор драйвера устройства, полученный в результате вызова функции UniDriverGetDeviceHandle()
[in]	mode	Одна из констант перечисления RSH_GET
[in,out]	value	Указатель на переменную, в которую будут помещены данные.

Возвращает

RSH_API_SUCCESS или код ошибки.

Данная функция - аналог функции UniDriverGet(). Отличие в том, что для передачи данных не используется специальная структура данных - можно просто передать указатель на переменную нужного типа.
Тип данных, указанный в описании Get-кода, который подходит для данной функции: RSH_U32

Предупреждения

Память под данные должна быть выделена заранее, в программе пользователя.

Сигнатура функции из RshUniDriver.dll:

unsigned __stdcall UniDriverLVGetUInt(unsigned int deviceHandle, unsigned int mode,unsigned int* value);

---

GetCString.vi

Получение информации об устройстве или библиотеке (char* - строка).

Параметры VI:

Параметр	Тип	Описание
deviceHandle		Идентификатор драйвера устройства, полученный в результате вызова модуля GetDeviceHandle.vi
error in (no error)		Контроль ошибок (вход)
mode		Одна из констант перечисления RSH_GET. Для данного VI подходят константы, в описании которых указан тип данных RSH_S8P
value in		Входные данные. Иногда нужно передать какое-либо значение в библиотеку абстракции, а не прочитать его. В этом случае нужно задать значение, иначе данный параметр можно игнорировать.
function return		Возвращаемое значение - RSH_API_SUCCESS или код ошибки.
error out		Контроль ошибок (выход)
value out		Выходные данные. Полученное в результате выполнения функции значение.
deviceHandle out		Идентификатор драйвера устройства, полученный в результате вызова модуля GetDeviceHandle.vi (выход). Значение данного параметра не меняется в процессе выполнения, и нужно только для контроля за потоком выполнения программы в LabVIEW (последовательность вызова VI).

Описание функции:

Аргументы

[in]	deviceHandle	Идентификатор драйвера устройства, полученный в результате вызова функции UniDriverGetDeviceHandle()
[in]	mode	Одна из констант перечисления RSH_GET
[in,out]	value	Указатель на массив, в который будут помещены данные.
[in]	maxLength	Максимальный размер строки (должен быть равен размеру выделенной памяти в буфере value).

Возвращает

RSH_API_SUCCESS или код ошибки.

Данная функция - аналог функции UniDriverGet(). Отличие в том, что для передачи данных не используется специальная структура данных - можно просто передать указатель на переменную нужного типа.
Тип данных, указанный в описании Get-кода, который подходит для данной функции: RSH_S8P

Предупреждения

Память под данные должна быть выделена заранее, в программе пользователя. Внутри библиотеки UniDriver происходит только копирование в переданный буфер.

Сигнатура функции из RshUniDriver.dll:

unsigned __stdcall UniDriverLVGetCstr(unsigned int deviceHandle, unsigned int mode, char* value);

---

IRshDevice::GetData - получение данных

Для получения буфера данных в библиотеке RshUniDriver.dll используется ряд функций, которые являются аналогами метода IRshDevice::GetData(), но при этом жестко типизированы.

GetDataChar.vi

Получение (передача) буфера с данными (массив char*)

Параметры VI:

Параметр	Тип	Описание
deviceHandle		Идентификатор драйвера устройства, полученный в результате вызова модуля GetDeviceHandle.vi
getDataMode		Дополнительные параметры (одна из констант перечисления RSH_DATA_MODES). Используйте RSH_DATA_MODE_NO_FLAGS если не требуется выполнять каких-либо дополнительных действий с данными в буфере.
size		Размер массива - максимальное количество элементов, которые можно скопировать в массив
error in (no error)		Контроль ошибок (вход)
function return		Возвращаемое значение - RSH_API_SUCCESS или код ошибки.
error out		Контроль ошибок (выход)
deviceHandle out		Идентификатор драйвера устройства, полученный в результате вызова модуля GetDeviceHandle.vi (выход). Значение данного параметра не меняется в процессе выполнения, и нужно только для контроля за потоком выполнения программы в LabVIEW (последовательность вызова VI).
buffer		Заполненный данными буфер. Размер массива равен фактическому количеству скопированных элементов.

Описание функции:

Аргументы

[in]	deviceHandle	Идентификатор драйвера устройства, полученный в результате вызова функции UniDriverGetDeviceHandle()
[in]	getDataMode	Дополнительные параметры (одна из констант перечисления RSH_DATA_MODES). Используйте RSH_DATA_MODE_NO_FLAGS если не требуется выполнять каких-либо дополнительных действий с данными в буфере.
[in]	size	Размер массива - максимальное количество элементов, которые можно скопировать в массив, указатель на который передается в параметре buffer.
[in,out]	received	После успешного выполнения функции в даннной переменной будет возвращено количество фактически скопированных элементов.
[in,out]	buffer	Указатель на массив, в который будут скопированы данные

Возвращает

RSH_API_SUCCESS или код ошибки.

Данная функция - аналог функции UniDriverGetData(). Отличие в том, что для передачи данных не используется специальная структура данных - можно просто передать указатель на массив нужного типа.

Предупреждения

Память под данные должна быть выделена заранее, в программе пользователя. Внутри библиотеки UniDriver происходит только копирование в переданный буфер.

Сигнатура функции из RshUniDriver.dll:

unsigned __stdcall UniDriverLVGetDataChar(unsigned int deviceHandle, unsigned int getDataMode,unsigned int size, unsigned int* received, char* buffer);

---

GetDataDouble.vi

Получение (передача) буфера с данными (массив double*)

Параметры VI:

Параметр	Тип	Описание
deviceHandle		Идентификатор драйвера устройства, полученный в результате вызова модуля GetDeviceHandle.vi
getDataMode		Дополнительные параметры (одна из констант перечисления RSH_DATA_MODES). Используйте RSH_DATA_MODE_NO_FLAGS если не требуется выполнять каких-либо дополнительных действий с данными в буфере.
size		Размер массива - максимальное количество элементов, которые можно скопировать в массив
error in (no error)		Контроль ошибок (вход)
function return		Возвращаемое значение - RSH_API_SUCCESS или код ошибки.
error out		Контроль ошибок (выход)
deviceHandle out		Идентификатор драйвера устройства, полученный в результате вызова модуля GetDeviceHandle.vi (выход). Значение данного параметра не меняется в процессе выполнения, и нужно только для контроля за потоком выполнения программы в LabVIEW (последовательность вызова VI).
buffer		Заполненный данными буфер. Размер массива равен фактическому количеству скопированных элементов.

Описание функции:

Аргументы

[in]	deviceHandle	Идентификатор драйвера устройства, полученный в результате вызова функции UniDriverGetDeviceHandle()
[in]	getDataMode	Дополнительные параметры (одна из констант перечисления RSH_DATA_MODES). Используйте RSH_DATA_MODE_NO_FLAGS если не требуется выполнять каких-либо дополнительных действий с данными в буфере.
[in]	size	Размер массива - максимальное количество элементов, которые можно скопировать в массив, указатель на который передается в параметре buffer.
[in,out]	received	После успешного выполнения функции в даннной переменной будет возвращено количество фактически скопированных элементов.
[in,out]	buffer	Указатель на массив, в который будут скопированы данные

Возвращает

RSH_API_SUCCESS или код ошибки.

Данная функция - аналог функции UniDriverGetData(). Отличие в том, что для передачи данных не используется специальная структура данных - можно просто передать указатель на массив нужного типа.

Предупреждения

Память под данные должна быть выделена заранее, в программе пользователя. Внутри библиотеки UniDriver происходит только копирование в переданный буфер.

Сигнатура функции из RshUniDriver.dll:

unsigned __stdcall UniDriverLVGetDataDouble(unsigned int deviceHandle, unsigned int getDataMode,unsigned int size, unsigned int* received, double* buffer);

---

GetDataShort.vi

Получение (передача) буфера с данными (массив short*)

Параметры VI:

Параметр	Тип	Описание
deviceHandle		Идентификатор драйвера устройства, полученный в результате вызова модуля GetDeviceHandle.vi
getDataMode		Дополнительные параметры (одна из констант перечисления RSH_DATA_MODES). Используйте RSH_DATA_MODE_NO_FLAGS если не требуется выполнять каких-либо дополнительных действий с данными в буфере.
size		Размер массива - максимальное количество элементов, которые можно скопировать в массив
error in (no error)		Контроль ошибок (вход)
function return		Возвращаемое значение - RSH_API_SUCCESS или код ошибки.
error out		Контроль ошибок (выход)
deviceHandle out		Идентификатор драйвера устройства, полученный в результате вызова модуля GetDeviceHandle.vi (выход). Значение данного параметра не меняется в процессе выполнения, и нужно только для контроля за потоком выполнения программы в LabVIEW (последовательность вызова VI).
buffer		Заполненный данными буфер. Размер массива равен фактическому количеству скопированных элементов.

Описание функции:

Аргументы

[in]	deviceHandle	Идентификатор драйвера устройства, полученный в результате вызова функции UniDriverGetDeviceHandle()
[in]	getDataMode	Дополнительные параметры (одна из констант перечисления RSH_DATA_MODES). Используйте RSH_DATA_MODE_NO_FLAGS если не требуется выполнять каких-либо дополнительных действий с данными в буфере.
[in]	size	Размер массива - максимальное количество элементов, которые можно скопировать в массив, указатель на который передается в параметре buffer.
[in,out]	received	После успешного выполнения функции в даннной переменной будет возвращено количество фактически скопированных элементов.
[in,out]	buffer	Указатель на массив, в который будут скопированы данные

Возвращает

RSH_API_SUCCESS или код ошибки.

Данная функция - аналог функции UniDriverGetData(). Отличие в том, что для передачи данных не используется специальная структура данных - можно просто передать указатель на массив нужного типа.

Предупреждения

Память под данные должна быть выделена заранее, в программе пользователя. Внутри библиотеки UniDriver происходит только копирование в переданный буфер.

Сигнатура функции из RshUniDriver.dll:

unsigned __stdcall UniDriverLVGetDataShort(unsigned int deviceHandle, unsigned int getDataMode,unsigned int size, unsigned int* received, short* buffer);

---

GetDataInt.vi

Получение (передача) буфера с данными (массив int*)

Параметры VI:

Параметр	Тип	Описание
deviceHandle		Идентификатор драйвера устройства, полученный в результате вызова модуля GetDeviceHandle.vi
getDataMode		Дополнительные параметры (одна из констант перечисления RSH_DATA_MODES). Используйте RSH_DATA_MODE_NO_FLAGS если не требуется выполнять каких-либо дополнительных действий с данными в буфере.
size		Размер массива - максимальное количество элементов, которые можно скопировать в массив
error in (no error)		Контроль ошибок (вход)
function return		Возвращаемое значение - RSH_API_SUCCESS или код ошибки.
error out		Контроль ошибок (выход)
deviceHandle out		Идентификатор драйвера устройства, полученный в результате вызова модуля GetDeviceHandle.vi (выход). Значение данного параметра не меняется в процессе выполнения, и нужно только для контроля за потоком выполнения программы в LabVIEW (последовательность вызова VI).
buffer		Заполненный данными буфер. Размер массива равен фактическому количеству скопированных элементов.

Описание функции:

Аргументы

[in]	deviceHandle	Идентификатор драйвера устройства, полученный в результате вызова функции UniDriverGetDeviceHandle()
[in]	getDataMode	Дополнительные параметры (одна из констант перечисления RSH_DATA_MODES). Используйте RSH_DATA_MODE_NO_FLAGS если не требуется выполнять каких-либо дополнительных действий с данными в буфере.
[in]	size	Размер массива - максимальное количество элементов, которые можно скопировать в массив, указатель на который передается в параметре buffer.
[in,out]	received	После успешного выполнения функции в даннной переменной будет возвращено количество фактически скопированных элементов.
[in,out]	buffer	Указатель на массив, в который будут скопированы данные

Возвращает

RSH_API_SUCCESS или код ошибки.

Данная функция - аналог функции UniDriverGetData(). Отличие в том, что для передачи данных не используется специальная структура данных - можно просто передать указатель на массив нужного типа.

Предупреждения

Память под данные должна быть выделена заранее, в программе пользователя. Внутри библиотеки UniDriver происходит только копирование в переданный буфер.

Сигнатура функции из RshUniDriver.dll:

unsigned __stdcall UniDriverLVGetDataInt(unsigned int deviceHandle, unsigned int getDataMode,unsigned int size, unsigned int* received, int* buffer);

---

Конструкторы

В данном разделе описываются VI, которые служат для формирования структур данных - заполнение структур (кластеров), формирование управляющих слов и т.п.

RshChannelParams.vi

Данный модуль используется для формирования кластера RshChannel.clb

Параметры VI:

Параметр	Тип	Описание
Use		Использовать или нет данный канал при сборе данных
Synchro		Использовать или нет данный канал в качестве источника синхронизации
Resist		Входное сопротивление аналогового канала
Coupling		Открыть или закрыть вход (актуально только при использовании 1МОм входа)
adjustment		Подстройка (смещение) уровня входного напряжения для данного канала. Данный параметр задается в вольтах. См. также RSH_CAPS_DEVICE_INPUT_LEVEL_ADJUSTMENT
gain		Коэффициент усиления, который будет использован для данного канала при сборе данных

---

RshControlDMAParams.vi

Данный модуль используется для формирования управляющего слова, которое используется в структуре инициализации RshInitDMA (кластер RshInitDMA.clb)

Параметры VI:

Параметр	Тип	Описание
DiffMode		Переключение между дифференциальным и однополюсным режимами работы
FrameMode		Включение или выключение кадрового сбора
MulSwitchStart		Выбор момента переключения мультиплексора (не используется в данный момент, возможно будет удалено в следующих релизах!)
Control		Сформированное управляющее слово (можно передать в поле Control структуры инициализации RshInitDMA)

---

RshControlMemoryParams.vi

Данный модуль используется для формирования управляющего слова, которое используется в структуре инициализации RshInitMemory (кластер RshInitMemory.clb)

Параметры VI:

Параметр	Тип	Описание
FreqMode		Выбор одного из режимов работы: стандартный, удвоение частоты, учетверение частоты
Control		Результат - сформированное управляющее слово

---

RshControlSynchroParams.vi

Данный модуль используется для формирования управляющего слова с дополнительными параметрами внешней синхронизации (поле ControlSynchro структуры инициализации RshInitMemory.clb)

Параметры VI:

Параметр	Тип	Описание
Slope		Выбор способа синхронизации: по фронту или по спаду сигнала
FrequencySwitch		Использование переключения частоты дискретизации для предыстории/истории. Если включено, "история" и "предыстория" сигнала будут писаться с разными частотами дискретизации.
Control		Сформированное управляющее слово

---

RshSynchroChannelParams.vi

Данный модуль используется для заполнения кластера RshSynchroChannel.ctl

Параметры VI:

Параметр	Тип	Описание
Filter		Использование фильтра для входа внешней синхронизации
Resist		Входное сопротивления для канала внешней синхронизации.
Coupling		Переключение состояния входа внешней синхронизации "открытый"/"закрытый" (актуально только при использовании 1МОм входа)
gain		Коэффициент усиления для входа внешней синхронизации
Synchro Channel		Заполненная структура (кластер) с параметрами входа внешней синхронизации