Текущий раздел:

Описания RDS

Приложения

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

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

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

А.5.6.26. rdsGetFirstBlock – первый блок в подсистеме

# Приложения

## Приложение А. Функции, константы и структуры 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 для перебора всех блоков заданной подсистемы.

См. также

rdsGetNextBlock, rdsEnumBlocks, RDS_BLOCKDESCRIPTION.