В этой главе описываются, как использовать основанный на XML язык разметки, чтобы задать источник, свойство и аппаратную информацию о триггере в Файле устройств Обработки изображений (IMDF).
Создание IMDF требуется. Используя файл IMDF может упростить кодирование функции getDeviceAttributes()
вашего адаптера. Кроме того, это - единственный удобный способ сделать текст справки доступным для специфичных для устройства свойств, которые создает ваш адаптер.
Когда пользователь вызывает функцию imaqhwinfo
, тулбокс ищет адаптер DLLs. Когда это находит DLL, это также ищет соответствие файл IMDF в тех же директориях. Если найдено, механизм хранит информацию пути к файлу IMDF. Файл IMDF должен находиться в той же директории как ваш DLL и расширение файла .imdf
, такое как demoimaq.imdf
.
Когда пользователь вызывает функцию videoinput
, чтобы создать объект ввода видео, чтения механизма и обрабатывает файл IMDF. Когда это читает файл, это обрабатывает свойство, триггер и информацию источника, указанную на верхнем уровне файла. (Чтобы понять иерархическую организацию файла IMDF, смотрите Элементы Языка разметки IMDF.)
После чтения всех элементов верхнего уровня механизм ищет элемент устройства, который совпадает с устройством пользователь, заданный в функции videoinput
. Если найдено, механизм затем ищет элемент формата видео в элементе устройства.
Механизм затем вызывает функцию getDeviceAttributes()
вашего адаптера, как описано в Реализации Добираются и Поддержка Набора Device-Specific Properties, чтобы настроить свойства устройства.
Следующие данные показывают иерархическое отношение элементов основанного на XML языка разметки для файлов IMDF. Данные показывают, какие элементы могут быть дочерними элементами других элементов. Элементы на верхнем уровне файла IMDF (элементы, которые являются дочерними элементами элемента ImageAcquisitionInfo
, применяются к целому адаптеру. Элементы, которые являются дочерними элементами элемента Device
, применяются только к тому устройству. Чтобы упростить схему, все возможные зависимые элементы не всегда показывают для элементов ниже верхнего уровня. Когда используется в файле IMDF, элементы называются узлами.
Иерархия элементов IMDF