Приложения

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

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

А.5.23. Вспомогательный объект для изменения связей и шин

А.5.23.8. rdsCECreateConnBus – создание связи или шины по данным объекта

Функция rdsCECreateConnBus создает новую связь или шину по данным указанного вспомогательного объекта.

  RDS_CHANDLE RDSCALL rdsCECreateConnBus(
    RDS_HOBJECT Editor,  // Объект
    RDS_BHANDLE Parent,  // Подсистема
    int Type,            // Связь или шина
    int *pError          // Результат
  );

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

RDS_ChHoBhIpI

Параметры

Editor (RDS_HOBJECT)

Идентификатор вспомогательного объекта для редактирования связи/шины, ранее созданного функцией rdsCECreateEditor.

Parent (RDS_BHANDLE)

Идентификатор подсистемы, внутри которой создается связь или шина.

Type (int)

Тип создаваемого объекта: RDS_CTCONNECTION – создать связь, RDS_CTBUS – создать шину.

pError (int*)

Указатель на целую переменную, в которую функция запишет результат создания связи или шины (код ошибки):

RDS_HCE_ERR_OK	Операция выполнена без ошибок.
RDS_HCE_ERR_BADOBJECT	Editor не является идентификатором вспомогательного объекта для редактирования связи/шины.
RDS_HCE_ERR_INVBLKBUS	Подсистема с идентификатором Parent отсутствует в схеме.
RDS_HCE_ERR_BADLINE	Одна из линий связи ссылается на номер точки, отсутствующей в объекте (линия, соединяющая точки, добавлена в объект, а одна из этих точек – нет).
RDS_HCE_ERR_ALLOC	Прочие ошибки.

Если вызывающей программе не нужен код ошибки, в параметре pError можно передать NULL.

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

Идентификатор созданной связи или шины, или NULL в случае ошибки.

Примечания

Эта функция создает в подсистеме Parent связь или шину (в зависимости от параметра Type) согласно набору точек и линий, содержащемуся во вспомогательном объекте Editor. При создании шины из объекта также читается набор каналов передачи данных.

При создании связей и шин RDS создает в памяти множество дополнительных служебных структур, обеспечивающих их работу. Если планируется последовательное создание нескольких связей или шин, имеет смысл предварительно вызвать функцию rdsSetSystemUpdate с параметром FALSE, а после создания всех связей/шин вызвать ее же с параметром TRUE. Это приведет к тому, что все вспомогательные структуры будут обновляться не после создания каждой связи, а после завершения создания всех связей (в момент вызова функции с параметром TRUE), что может заметно ускорить работу RDS.

Пример

Пример использования функции rdsCECreateConnBus приведен в §2.16.2 руководства программиста.

См. также

rdsCECreateEditor, rdsCEEditConnBus, rdsSetSystemUpdate.