hw_module_t Referensi Struktur

Bidang Data
hw_module_t Referensi Struktur

#include < hardware.h >

Bidang Data

uint32_t menandai
uint16_t module_api_version
uint16_t hal_api_version
karakter konstan * pengenal
karakter konstan * nama
karakter konstan * pengarang
struct hw_module_methods_t * metode
ruang kosong * dso
uint32_t dilindungi undang-undang [32-7]

Detil Deskripsi

Setiap modul perangkat keras harus memiliki struktur data bernama HAL_MODULE_INFO_SYM dan bidang struktur data ini harus dimulai dengan hw_module_t diikuti dengan informasi spesifik modul.

Definisi pada baris 86 file hardware.h .

Dokumentasi Lapangan

const char* penulis

Penulis/pemilik/pelaksana modul

Definisi pada baris 139 file hardware.h .

batal* begitu

dso modul

Definisi pada baris 145 file hardware.h .

uint16_t hal_api_version

Definisi version_major/version_minor disediakan di sini untuk kompatibilitas kode sumber sementara. Mereka akan dihapus di versi berikutnya. SEMUA klien harus mengonversi ke format versi baru. Versi API dari antarmuka modul HAL. Ini dimaksudkan untuk membuat versi struktur dan definisi hw_module_t , hw_module_methods_t , dan hw_device_t .

Antarmuka HAL memiliki bidang ini. Pengguna/implementasi modul TIDAK boleh bergantung pada nilai ini untuk informasi versi.

Saat ini, 0 adalah satu-satunya nilai yang valid.

Definisi pada baris 129 file hardware.h .

const char*id

Pengidentifikasi modul

Definisi pada baris 133 file hardware.h .

struct hw_module_methods_t * metode

Metode modul

Definisi pada baris 142 file hardware.h .

uint16_t module_api_version

Versi API dari modul yang diimplementasikan. Pemilik modul bertanggung jawab untuk memperbarui versi ketika antarmuka modul berubah.

Modul turunan seperti gralloc dan audio memiliki dan mengelola bidang ini. Pengguna modul harus menafsirkan bidang versi untuk memutuskan apakah akan beroperasi dengan implementasi modul yang disediakan atau tidak. Misalnya, SurfaceFlinger bertanggung jawab untuk memastikan bahwa ia mengetahui cara mengelola berbagai versi API gralloc-module, dan AudioFlinger harus mengetahui cara melakukan hal yang sama untuk API modul audio.

Versi modul API harus menyertakan komponen mayor dan minor. Misalnya, versi 1.0 dapat direpresentasikan sebagai 0x0100. Format ini menyiratkan bahwa versi 0x0100-0x01ff semuanya kompatibel dengan API.

Di masa depan, libhardware akan mengekspos fungsi hw_get_module_version() (atau yang setara) yang akan menggunakan versi minimum/maksimum yang didukung sebagai argumen dan akan mampu menolak modul dengan versi di luar rentang yang disediakan.

Definisi pada baris 111 file hardware.h .

nama const char*

Nama modul ini

Definisi pada baris 136 file hardware.h .

uint32_t dipesan[32-7]

padding hingga 128 byte, dicadangkan untuk penggunaan di masa mendatang

Definisi pada baris 151 file hardware.h .

tanda uint32_t

tag harus diinisialisasi ke HARDWARE_MODULE_TAG

Definisi pada baris 88 file hardware.h .

Dokumentasi untuk struct ini dihasilkan dari file berikut: