Приложения

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

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

А.5.6. Операции с блоками и связями

А.5.6.36. rdsGetPointDescription – получить описание точки связи

Функция rdsGetPointDescription возвращает описание точки связи или шины с заданным номером.

  int RDSCALL rdsGetPointDescription(
    RDS_CHANDLE Conn,                // Связь
    int PointNum,                    // Номер точки
    RDS_PPOINTDESCRIPTION pPoint     // Описание точки
  );

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

RDS_IChIPd

Параметры

Conn (RDS_CHANDLE): Идентификатор связи или шины, которой принадлежит точка.
PointNum (int): Номер точки (нумерация точек в связях начинается с нуля).
pPoint (RDS_PPOINTDESCRIPTION): Указатель на структуру описания точки связи RDS_POINTDESCRIPTION, которую функция должна заполнить параметрами указанной точки. Если вызывающей программе не нужно это описание, в этом параметре можно передать NULL.

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

1 – точка с номером PointNum есть в связи Conn и размеры переданной в pPoint структуры правильные, 0 – точки с таким номером нет или размер структуры (поле servSize) не соответствует ожиданиям функции.

Примечания

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

Пример

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

См. также

RDS_POINTDESCRIPTION, rdsGetConnDescription, RDS_CONNDESCRIPTION.