Referensi Struktur FlpLocationInterface

Referensi Struktur FlpLocationInterface

#include < fused_location.h >

Bidang Data

ukuran_t ukuran
ke dalam(* init )( FlpCallback *panggilan balik)
ke dalam(* dapatkan_batch_size )()
ke dalam(* start_batching )(int id, FlpBatchOptions *pilihan)
ke dalam(* update_batching_options )(int id, FlpBatchOptions *new_options)
ke dalam(* stop_batching )(ke dalam id)
ruang kosong(* membersihkan )()
ruang kosong(* get_batched_location )(int last_n_locations)
ke dalam(* inject_location )( FlpLocation *lokasi)
konstan batal *(* get_extension )(const char *nama)
ruang kosong(* flush_batched_locations )()

Detil Deskripsi

Mewakili antarmuka FLP standar.

Definisi pada baris 321 file menyatu_lokasi.h .

Dokumentasi Lapangan

batal(* pembersihan)()

Menutup antarmuka. Jika ada operasi batch yang sedang berlangsung, operasi tersebut harus dihentikan.

Definisi pada baris 398 file menyatu_lokasi.h .

batal(* flush_batched_locations)()

Ambil semua lokasi batch yang saat ini disimpan dan hapus buffer. flp_location_callback HARUS dipanggil sebagai respons, meskipun tidak ada lokasi yang akan di-flush (dalam hal ini num_locations harus 0). Panggilan berikutnya ke get_batched_location atau flush_batched_locations tidak boleh mengembalikan lokasi mana pun yang dikembalikan dalam panggilan ini.

Definisi pada baris 436 file menyatu_lokasi.h .

int(*get_batch_size)()

Mengembalikan ukuran batch (dalam jumlah objek FlpLocation ) yang tersedia di perangkat keras. Perlu diperhatikan, penerapan HW yang berbeda mungkin memiliki ukuran sampel yang berbeda. Ini akan mengembalikan jumlah sampel yang ditentukan dalam format FlpLocation . Ini akan digunakan oleh lapisan atas, untuk memutuskan interval batching dan apakah AP harus dibangunkan atau tidak.

Definisi pada baris 343 file menyatu_lokasi.h .

batal(* get_batched_location)(int last_n_locations)

Dapatkan lokasi gabungan yang telah dikumpulkan. flp_location_callback digunakan untuk mengembalikan lokasi. Objek lokasi dikeluarkan dari buffer hanya ketika buffer penuh. Jangan menghapusnya dari buffer hanya karena sudah dikembalikan menggunakan callback. Dengan kata lain, bila tidak ada objek lokasi baru, dua panggilan ke get_batched_location(1) akan mengembalikan objek lokasi yang sama. Parameter: last_n_locations - Jumlah lokasi yang akan didapat. Ini bisa berupa satu atau banyak. Jika last_n_locations adalah 1, Anda mendapatkan lokasi terbaru yang diketahui perangkat keras.

Definisi pada baris 412 file menyatu_lokasi.h .

const void*(* get_extension)(const char *nama)

Dapatkan penunjuk ke informasi ekstensi.

Definisi pada baris 427 file menyatu_lokasi.h .

int(* init)( FlpCallback *panggilan balik)

Membuka antarmuka dan menyediakan rutinitas panggilan balik untuk implementasi antarmuka ini. Setelah dipanggil, Anda harus merespons dengan memanggil flp_capabilities_callback di FlpCallbacks untuk menentukan kemampuan yang didukung implementasi Anda.

Definisi pada baris 333 file menyatu_lokasi.h .

int(* inject_location)( FlpLocation *lokasi)

Menyuntikkan lokasi saat ini dari penyedia lokasi lain garis lintang dan bujur diukur dalam derajat akurasi yang diharapkan diukur dalam meter Parameter: lokasi - Objek lokasi yang disuntikkan. Nilai yang dikembalikan: FLP_RESULT_SUCCESS atau FLP_RESULT_ERROR.

Definisi pada baris 422 file menyatu_lokasi.h .

ukuran_t ukuran

atur ke sizeof(FlpLocationInterface)

Definisi pada baris 325 file menyatu_lokasi.h .

int(* start_batching)(int id, FlpBatchOptions *pilihan)

Mulai mengelompokkan lokasi. API ini terutama digunakan ketika AP sedang tidur dan perangkat dapat mengelompokkan lokasi di perangkat keras. flp_location_callback digunakan untuk mengembalikan lokasi. Ketika buffer penuh dan FLP_BATCH_WAKEUP_ON_FIFO_FULL digunakan, AP akan dibangunkan. Ketika buffer penuh dan FLP_BATCH_WAKEUP_ON_FIFO_FULL tidak disetel, objek lokasi terlama akan dihapus. Dalam hal ini AP tidak akan dibangunkan. Lapisan atas akan menggunakan get_batched_location API untuk menanyakan lokasi secara eksplisit. Jika FLP_BATCH_CALLBACK_ON_LOCATION_FIX disetel, implementasi akan memanggil flp_location_callback setiap kali ada perbaikan lokasi. Ini mengesampingkan pengaturan tanda FLP_BATCH_WAKEUP_ON_FIFO_FULL. Merupakan tanggung jawab lapisan atas (penelepon) untuk mematikannya, jika mereka mengetahui bahwa AP mungkin akan tertidur. Hal ini berguna untuk aplikasi navigasi ketika sistem berada dalam mode daya tinggi. Parameter: id - Id untuk permintaan. options - Lihat definisi struct FlpBatchOptions . Nilai yang dikembalikan: FLP_RESULT_SUCCESS jika berhasil, FLP_RESULT_INSUFFICIENT_MEMORY, FLP_RESULT_ID_EXISTS, FLP_RESULT_ERROR jika gagal.

Definisi pada baris 367 file menyatu_lokasi.h .

ke dalam(* stop_batching)(ke dalam id)

Hentikan pengelompokan. Parameter: id - Id untuk permintaan. Nilai Pengembalian: FLP_RESULT_SUCCESS jika berhasil, FLP_RESULT_ID_UNKNOWN atau FLP_RESULT_ERROR jika gagal.

Definisi pada baris 392 file menyatu_lokasi.h .

int(* update_batching_options)(int id, FlpBatchOptions *new_options)

Perbarui FlpBatchOptions yang terkait dengan permintaan pengelompokan. Ketika operasi pengelompokan sedang berlangsung dan opsi pengelompokan seperti FLP_BATCH_WAKEUP_ON_FIFO_FULL perlu diperbarui, API ini akan digunakan. Misalnya, hal ini dapat terjadi ketika AP dalam keadaan aktif dan aplikasi peta sedang digunakan. Parameter: id - Id permintaan batch yang ada. new_options - Nilai pengembalian FlpBatchOptions yang diperbarui: FLP_RESULT_SUCCESS jika berhasil, FLP_RESULT_ID_UNKNOWN, FLP_RESULT_ERROR jika terjadi kesalahan.

Definisi pada baris 382 file menyatu_lokasi.h .


Dokumentasi untuk struct ini dihasilkan dari file berikut: