hw_module_t مرجع الهيكل

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 .

علامة uint32_t

يجب تهيئة العلامة إلى HARDWARE_MODULE_TAG

التعريف في السطر 88 لملف الأجهزة . h.


تم إنشاء وثائق هذه البنية من الملف التالي:
  • هاردوير / ليباردوير / تشمل / هاردوير / هاردوير