hw_module_t مرجع الهيكل
#include < hardware.h >
حقول البيانات | |
| uint32_t | بطاقة شعار |
| uint16_t | module_api_version |
| uint16_t | hal_api_version |
| حرف كونست * | هوية شخصية |
| حرف كونست * | اسم |
| حرف كونست * | مؤلف |
| هيكل hw_module_methods_t * | طُرق |
| فارغ * | dso |
| uint32_t | محفوظة [32-7] |
وصف مفصل
يجب أن تحتوي كل وحدة نمطية للأجهزة على بنية بيانات تسمى HAL_MODULE_INFO_SYM ويجب أن تبدأ حقول بنية البيانات هذه بـ hw_module_t متبوعة بمعلومات خاصة بالوحدة النمطية.
التعريف في السطر 86 من ملف Hardware.h .
التوثيق الميداني
| مؤلف const char * |
المؤلف / مالك / منفذ الوحدة
التعريف في السطر 139 من ملف Hardware.h .
| باطل * dso |
وحدة dso
التعريف في السطر 145 لملف Hardware.h .
| uint16_t hal_api_version |
version_major / version_minor التي تحددها متوفرة هنا للتوافق المؤقت مع كود المصدر. ستتم إزالتها في الإصدار التالي. يجب على جميع العملاء التحويل إلى تنسيق الإصدار الجديد. إصدار API لواجهة وحدة HAL. هذا مخصص لإصدار هياكل وتعريفات hw_module_t و hw_module_methods_t و hw_device_t .
تمتلك واجهة HAL هذا الحقل. يجب ألا يعتمد مستخدمو / تطبيقات الوحدة النمطية على هذه القيمة للحصول على معلومات الإصدار.
حاليًا ، 0 هو القيمة الصالحة الوحيدة.
التعريف في السطر 129 من ملف Hardware.h .
| رمز كونستار * معرف |
معرّف الوحدة
التعريف في السطر 133 لملف Hardware.h .
طرق الوحدات
تعريف في السطر 142 من ملف Hardware.h .
| uint16_t module_api_version |
إصدار API للوحدة المنفذة. مالك الوحدة مسؤول عن تحديث الإصدار عند تغيير واجهة الوحدة.
الوحدات المشتقة مثل gralloc والصوت تمتلك هذا المجال وتديره. يجب على مستخدم الوحدة النمطية تفسير حقل الإصدار ليقرر ما إذا كان سيتفاعل مع تنفيذ الوحدة المصاحبة أم لا. على سبيل المثال ، يعد SurfaceFlinger مسؤولاً عن التأكد من أنه يعرف كيفية إدارة الإصدارات المختلفة من واجهة برمجة التطبيقات الخاصة بوحدة gralloc ، ويجب أن يعرف AudioFlinger كيفية القيام بنفس الشيء مع واجهة برمجة تطبيقات وحدة الصوت.
يجب أن يشتمل إصدار واجهة برمجة التطبيقات للوحدة النمطية على مكون رئيسي وثانوي. على سبيل المثال ، يمكن تمثيل الإصدار 1.0 كـ 0x0100. يشير هذا التنسيق إلى أن الإصدارات 0x0100-0x01ff جميعها متوافقة مع API.
في المستقبل ، سيعرض libhardware الدالة hw_get_module_version () (أو ما يعادلها) التي ستتخذ الحد الأدنى / الحد الأقصى من الإصدارات المدعومة كوسائط وستكون قادرة على رفض الوحدات ذات الإصدارات خارج النطاق المقدم.
التعريف في السطر 111 لملف Hardware.h .
| اسم الحرف * |
اسم هذه الوحدة
تعريف في السطر 136 من ملف Hardware.h .
| uint32_t محفوظة [32-7] |
مساحة تصل إلى 128 بايت ، محجوزة للاستخدام في المستقبل
التعريف في السطر 151 من ملف Hardware.h .
تم إنشاء وثائق هذه البنية من الملف التالي:
- هاردوير / ليباردوير / تشمل / هاردوير / هاردوير