Документация

Передача данных в COM-объекты

При использовании COM-объекта в команде MATLAB ® передаваемые в вызове типы MATLAB преобразуются в типы, собственные для COM-объекта. MATLAB выполняет это преобразование для каждого переданного аргумента. В этом разделе описывается преобразование.

MATLAB преобразует аргументы MATLAB в типы, которые наилучшим образом представляют данные для COM-объекта. В следующей таблице показаны все базовые типы MATLAB для переданных аргументов и типы COM, определенные для входных аргументов. В каждой строке отображается тип MATLAB, за которым следуют возможные совпадения аргументов COM. Описание типов вариантов COM см. в таблице в разделе Обработка данных из объектов COM.

Обработка данных из COM-объектов

Данные, возвращаемые COM-объектом, часто несовместимы с типами MATLAB. Когда это происходит, MATLAB преобразует возвращаемое значение в тип данных, собственный языку MATLAB. В этом разделе описывается преобразование, выполняемое для различных типов, которые могут быть возвращены из COM-объектов.

В следующей таблице показано, как MATLAB преобразует данные из COM-объекта в переменные MATLAB.

Неподдерживаемые типы

MATLAB не поддерживает следующие типы COM-интерфейсов.

Передача MATLAB SAFEARRAY объекту COM

SAFEARRAY тип данных является стандартным способом передачи массивов между COM-объектами. В этом разделе объясняется, как проходит MATLAB SAFEARRAY данных в COM-объект.

• Поведение по умолчанию в MATLAB

• Примеры

• Пройти одномерный SAFEARRAY

• Пройти SAFEARRAY по ссылке

B = [2 3 4]
B =
     2     3     4

No. of dimensions: 2
Dim: 1, 	 No. of elements: 1 
Dim: 2, 	 No. of elements: 3 
	 	 Elements: 
	 	 2.0 
	 	 3.0 
	 	 4.0

C = [1;2;3]
C =
     1
     2
     3

No. of dimensions: 2
Dim: 1, 	 No. of elements: 3 
Dim: 2, 	 No. of elements: 1 
Elements: 
	 	 1.0 
	 	 2.0 
	 	 3.0

D = [2 3 4 5;5 6 7 8]

D =
     2     3     4     5
     5     6     7     8

No. of dimensions: 2
Dim: 1, 	 No. of elements: 2 
Dim: 2, 	 No. of elements: 4 
Elements: 
	 	 2.0 
	 	 3.0 
	 	 4.0 
	 	 5.0 
	 	 5.0 
	 	 6.0 
	 	 7.0 
	 	 8.0

Читать SAFEARRAY из объектов COM в приложениях MATLAB

В этом разделе объясняется, как MATLAB читает SAFEARRAY данные из COM-объекта.

MATLAB считывает одномерный SAFEARRAY с n элементы из COM-объекта в качестве 1около-n матрица.

MATLAB считывает двумерный SAFEARRAY с n элементы как 2около-n матрица.

MATLAB считывает трехмерный SAFEARRAY с двумя элементами в качестве 2около-2около-2 массив ячеек.

Отображение синтаксиса MATLAB для объектов COM

Чтобы определить, какие типы MATLAB следует использовать при передаче аргументов COM-объектам, используйте invoke или methodsview функции. Эти функции перечисляют все методы, найденные в объекте, а также спецификацию типов, необходимых для каждого аргумента.

Рассмотрим сервер с именем MyApp, который имеет один метод TestMeth1 со следующим синтаксисом:

HRESULT TestMeth1 ([out, retval] double* dret);

Этот метод не имеет входного аргумента и возвращает переменную типа double. Следующий псевдокод отображает синтаксис MATLAB для вызова метода.

h = actxserver('MyApp');
invoke(h)

MATLAB отображает:

ans = 
   TestMeth1 = double TestMeth1 (handle)

Подпись TestMeth1 является:

double TestMeth1(handle)

MATLAB требует использования дескриптора объекта в качестве входного аргумента для каждого метода в дополнение к любым входным аргументам, необходимым для самого метода.

Используйте одну из следующих псевдокодов для создания переменной var, который имеет тип double.

var = h.TestMeth1;

или:

var = TestMeth1(h);

Хотя следующий синтаксис верен, его использование не рекомендуется:

var = invoke(h,'TestMeth1');

Теперь рассмотрим сервер под названием MyApp1 следующими методами:

HRESULT TestMeth1 ([out, retval] double* dret);
HRESULT TestMeth2 ([in] double* d, [out, retval] double* dret);
HRESULT TestMeth3 ([out] BSTR* sout,
                   [in, out] double* dinout,
                   [in, out] BSTR* sinout,
                   [in] short sh,
                   [out] long* ln,
                   [in, out] float* b1,
                   [out, retval] double* dret);

Использование invoke MATLAB отображает список методов:

ans = 
   TestMeth1 = double TestMeth1 (handle)
   TestMeth2 = double TestMeth2 (handle, double)
   TestMeth3 = [double, string, double, string, int32, single] ...
               TestMeth3(handle, double, string, int16, single)

TestMeth2 требуется входной аргумент d типа doubleи возвращает переменную dret типа double. Некоторые псевдокодовые примеры вызова TestMeth2 являются:

var = h.TestMeth2(5);

или:

var = TestMeth2(h, 5);

TestMeth3 требует нескольких входных аргументов, как указано в скобках на правой стороне знака равенства, и возвращает несколько выходных аргументов, как указано в скобках на левой стороне знака равенства.

[double, string, double, string, int32, single]  %output arguments
TestMeth3(handle, double, string, int16, single) %input arguments

Первый входной аргумент является обязательным handle, за которым следуют четыре входных аргумента.

TestMeth3(handle, in1, in2, in3, in4)

Первым выходным аргументом является возвращаемое значение retval, за которыми следуют пять выходных аргументов.

[retval, out1, out2, out3, out4, out5]

Вот как аргументы сопоставляются с командой MATLAB:

[dret, sout, dinout, sinout, ln, b1] = TestMeth3(handle, ...
                                       dinout, sinout, sh, b1)

где dret является double, sout является string, dinout является double и является как входным, так и выходным аргументом, sinout является string (входной и выходной аргумент), ln является int32, b1 является single (входной и выходной аргумент), handle является дескриптором объекта, и sh является int16.