gis_data_raw_select_map_by_index()

Выбор карты в разделяемой области памяти по индексу.

Прототип:

#include <gis/gis_raw.h>
   
int gis_data_raw_select_map_by_index( gis_data_raw_context_t ctx, uint32_t index );

Аргументы:

ctx

Контекст gis_data_raw_context_t.

index

Индекс карты.

Библиотека:

gishelper

Описание:

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

---

При обновлении/перезаписи РОП карты могут изменить свое положение в РОП и, как следствие, изменить свой порядковый номер. Для обхода карт в РОП рекомендуется использовать gis_data_raw_select_first_map() и gis_data_raw_select_next_map().

---

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

EOK

Успешное завершение.

EINVAL

Некорректный индекс.

EBADFD

Некорректный указатель на разделяемую область памяти.

ENODATA

Отсутствуют карты в разделяемой области памяти.

Примеры использования:

gis_core_connection_t          connection;
gis_core_request_parameters_t  map;
gis_data_raw_context_t         raw_ctx;
gis_core_link_init( &connection );
gis_core_link_connect( &connection, 777 );
gis_core_databuffer_attach( &connection );
gis_core_request_parameters_init( &map );
gis_core_databuffer_data_request( &connection, &map, 1 );
gis_data_raw_ctx_alloc( &raw_ctx );
gis_data_raw_ctx_import_databuffer( raw_ctx );
if ( gis_data_raw_select_map_by_index( raw_ctx, 0 ) != EOK )
{
    printf( "Failed to select map by index: %d!\n", 0 );
    gis_data_raw_ctx_free( &raw_ctx );
      gis_core_databuffer_detach();
      gis_core_link_destroy( &connection, true );
    return 1;
} 
gis_data_raw_ctx_free( &raw_ctx );
gis_core_databuffer_detach();
gis_core_link_destroy( &connection, true );

Классификация:

ПК ЦКИ для ЗОСРВ «Нейтрино»

Безопасность использования

Обработчик прерываний

Нет

Обработчик сигналов

Нет

В потоке

Нет

Тематические ссылки:

gis_data_raw_context_t, gis_data_raw_select_next_map()

Предыдущий раздел: Описание API картографического фреймворка