Приложения

Приложение А. Функции, константы и структуры RDS

А.5. Сервисные функции и макросы RDS

А.5.35. Функции поддержки автоматической компиляции моделей

А.5.35.5. rdscompGetModelData – обслуживаемая модулем модель по номеру

Функция rdscompGetModelData возвращает указатель на структуру данных модели RDS_COMPMODELDATA, обслуживаемой указанным модулем автокомпиляции. Модель выбирается из списка модуля по указанному условному номеру.

  RDS_PCOMPMODELDATA RDSCALL rdscompGetModelData(
    RDS_COMPHANDLE Module,    // Модуль автокомпиляции
    int ModelNum              // Номер модели
  );

Тип указателя на эту функцию

RDS_MdChI

Параметры

Module (RDS_COMPHANDLE)

Идентификатор модуля автоматической компиляции, для которого нужно найти обслуживаемую модель.

ModelNum (int)

Номер модели во внутреннем списке моделей, обслуживаемых модулем Module. Модели в списке нумеруются начиная с нуля.

Возвращаемое значение

Указатель на структуру данных найденной модели RDS_COMPMODELDATA или NULL, если модуль в данный момент обслуживает меньше ModelNum+1 моделей (то есть номер ModelNum выходит за пределы размера списка моделей модуля).

Примечания

Эта функция обычно используется для перебора всех моделей, обслуживаемых конкретным модулем автокомпиляции, и выполнения с ними каких-либо действий. Параметр ModelNum при этом изменяется от нуля до значения, на единицу меньшего поля NModels структуры данных модуля RDS_COMPMODULEDATA.

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

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

См. также

RDS_COMPMODELDATA, RDS_COMPMODULEDATA, rdscompGetModelDataByName.