Приложения
Приложение А. Функции, константы и структуры RDS
А.5. Сервисные функции и макросы RDS
А.5.6. Операции с блоками и связями
А.5.6.26. rdsGetFirstBlock – первый блок в подсистеме
Функция rdsGetFirstBlock возвращает идентификатор самого первого блока в указанной подсистеме.
RDS_BHANDLE RDSCALL rdsGetFirstBlock( RDS_BHANDLE Parent, // Подсистема int Type, // Маска типов (RDS_BT*) RDS_PBLOCKDESCRIPTION pDescr // Заполняемое описание блока );
Тип указателя на эту функцию
RDS_BhBhIBd
Параметры
- Parent (RDS_BHANDLE)
- Идентификатор подсистемы, в которой нужно найти самый первый блок.
- Type (int)
- Маска типов блоков, среди которых ищется блок – стандартные константы типов блоков RDS_BT*, объединенные битовым ИЛИ. Если нужно найти первый блок любого типа, в этом параметре можно передать 0.
- pDescr (RDS_PBLOCKDESCRIPTION)
- Указатель на заполняемую функцией структуру описания найденного блока RDS_BLOCKDESCRIPTION. Если вызывающей программе не нужно это описание, в этом параметре можно передать NULL.
Возвращаемое значение
Идентификатор найденного блока (RDS_BHANDLE) или NULL, если в подсистеме Parent нет ни одного блока с указанными типами.
Примечания
Эта функция ищет в подсистеме Parent самый первый блок, принадлежащий одному из типов, указанных флагами в параметре Type. Порядок следования блоков в подсистеме (и понятие «самый первый блок» для этой функции) определяется внутренней логикой RDS и не может быть изменен программистом. Чаще всего эта функция используется вместе с функцией rdsGetNextBlock для перебора всех блоков заданной подсистемы.
См. также