מידע על המבנה של input_host_callbacks

שדות נתונים
מידע על המבנה של input_host_callbacks

#include < input.h >

שדות נתונים

input_device_identifier_t *(*  create_device_identifier )( input_host_t *host, const char *name, int32_t product_id, int32_t vendor_id, input_bus_t bus, const char *unique_id)
 
input_device_definition_t *(*  create_device_definition )( input_host_t *host)
 
input_report_definition_t *(*  create_input_report_definition )( input_host_t *host)
 
input_report_definition_t *(*  create_output_report_definition )( input_host_t *host)
 
void(*  free_report_definition )( input_host_t *host, input_report_definition_t *report_def)
 
void(*  input_device_definition_add_report )( input_host_t *host, input_device_definition_t *d, input_report_definition_t *r)
 
void(*  input_report_definition_add_collection )( input_host_t *host, input_report_definition_t *report, input_collection_id_t id, int32_t arity)
 
void(*  input_report_definition_declare_usage_int )( input_host_t *host, input_report_definition_t *report, input_collection_id_t id, input_usage_t usage, int32_t min, int32_t max, float resolution)
 
void(*  input_report_definition_declare_usages_bool )( input_host_t *host, input_report_definition_t *report, input_collection_id_t id, input_usage_t *usage, size_t usage_count)
 
input_device_handle_t *(*  register_device )( input_host_t *host, input_device_identifier_t *id, input_device_definition_t *d)
 
void(*  unregister_device )( input_host_t *host, input_device_handle_t *handle)
 
input_report_t *(*  input_allocate_report )( input_host_t *host, input_report_definition_t *r)
 
void(*  input_report_set_usage_int )( input_host_t *host, input_report_t *r, input_collection_id_t id, input_usage_t usage, int32_t value, int32_t arity_index)
 
void(*  input_report_set_usage_bool )( input_host_t *host, input_report_t *r, input_collection_id_t id, input_usage_t usage, bool value, int32_t arity_index)
 
void(*  report_event )( input_host_t *host, input_device_handle_t *d, input_report_t *report)
 
input_property_map_t *(*  input_get_device_property_map )( input_host_t *host, input_device_identifier_t *id)
 
input_property_t *(*  input_get_device_property )( input_host_t *host, input_property_map_t *map, const char *key)
 
const char *(*  input_get_property_key )( input_host_t *host, input_property_t *property)
 
const char *(*  input_get_property_value )( input_host_t *host, input_property_t *property)
 
void(*  input_free_device_property )( input_host_t *host, input_property_t *property)
 
void(*  input_free_device_property_map )( input_host_t *host, input_property_map_t *map)
 

תיאור מפורט

ההגדרה מופיעה בשורה 409 בקובץ input.h .

מסמכי תיעוד של שדה

input_device_definition_t *(* create_device_definition)( input_host_t *host)

הקצאת הגדרת המכשיר שתתאר את יכולות הקלט של המכשיר. אפשר להשתמש בהגדרת מכשיר כדי לרשום כמה מכשירים שרוצים.

ההגדרה נמצאת בשורה 424 בקובץ input.h .

input_device_identifier_t *(* create_device_identifier)( input_host_t *host, const char *name, int32_t product_id, int32_t vendor_id, input_bus_t bus, const char *unique_id)

יצירת מזהה מכשיר עם המאפיינים שצוינו. המזהה הייחודי צריך להיות מחרוזת שמזהה באופן מדויק פריט חומרה נתון. לדוגמה, מכשיר קלט שמחובר באמצעות Bluetooth יכול להשתמש בכתובת ה-MAC שלו כמזהה הייחודי שלו.

ההגדרה מופיעה בשורה 416 בקובץ input.h .

input_report_definition_t *(* create_input_report_definition)( input_host_t *host)

הקצאה של דוח קלט, ש-HAL ישתמש בו כדי להודיע למארח על אירועי קלט נכנסים, או דוח פלט, שדרכו המארח יוכל להודיע ל-HAL על שינויים רצויים במצב (למשל, הגדרת נורית LED).

ההגדרה נמצאת בשורה 431 בקובץ input.h .

input_report_definition_t *(* create_output_report_definition)( input_host_t *host)

ההגדרה נמצאת בשורה 432 בקובץ input.h .

void(* free_report_definition)( input_host_t *host, input_report_definition_t *report_def)

שחרור ההגדרה של הדוח.

ההגדרה מופיעה בשורה 437 בקובץ input.h .

input_report_t *(* input_allocate_report)( input_host_t *host, input_report_definition_t *r)

הקצאת דוח שיכיל את כל המצבים כפי שמתואר בדוח הנתון.

ההגדרה מופיעה בשורה 488 בקובץ input.h .

void(* input_device_definition_add_report)( input_host_t *host, input_device_definition_t *d, input_report_definition_t *r)

מוסיפים את הדוח למכשיר הקלט הנתון.

ההגדרה נמצאת בשורה 442 בקובץ input.h .

void(* input_free_device_property)( input_host_t *host, input_property_t *property)

הפונקציה משחררת את input_property_t*.

ההגדרה מופיעה בשורה 535 בקובץ input.h .

void(* input_free_device_property_map)( input_host_t *host, input_property_map_t *map)

הפונקציה משחררת את input_property_map_t*.

ההגדרה נמצאת בשורה 540 בקובץ input.h .

input_property_t *(* input_get_device_property)( input_host_t *host, input_property_map_t *map, const char *key)

אחזור נכס של המכשיר באמצעות המפתח הנתון. הפונקציה מחזירה את הערך NULL אם המפתח לא קיים, או את הערך input_property_t* שצריך לפנות באמצעות input_free_device_property()‎ . לא מוגדרת שימוש ב-input_property_t אחרי ש-input_property_map_t התואם מופטר.

ההגדרה נמצאת בשורה 517 בקובץ input.h .

input_property_map_t *(* input_get_device_property_map)( input_host_t *host, input_device_identifier_t *id)

אחזור קבוצת המאפיינים של המכשיר. אפשר להשתמש ב-input_property_map_t* המוחזר כדי לשלוח שאילתות לגבי מאפיינים ספציפיים באמצעות הפונקציה הלא סטטית input_get_device_property.

ההגדרה נמצאת בשורה 509 בקובץ input.h .

const char*(* input_get_property_key)( input_host_t *host, input_property_t *property)

אחזור המפתח של נכס הקלט. הפונקציה מחזירה ערך NULL אם המאפיין הוא NULL. הבעלות על const char* המוחזר היא של input_property_t.

ההגדרה נמצאת בשורה 524 בקובץ input.h .

const char*(* input_get_property_value)( input_host_t *host, input_property_t *property)

אחזור הערך של מאפיין הקלט. הפונקציה מחזירה ערך NULL אם המאפיין הוא NULL. הבעלות על const char* המוחזר היא של input_property_t.

ההגדרה נמצאת בשורה 530 בקובץ input.h .

void(* input_report_definition_add_collection)( input_host_t *host, input_report_definition_t *report, input_collection_id_t id, int32_t arity)

הוספת אוסף עם הארטיות והמזהה שצוינו. אוסף מתאר קבוצה של מאפיינים שמקובצים באופן לוגי, כמו הקואורדינטות X ו-Y של מגע של אצבע אחת או קבוצת המקשים במקלדת. הערך של ה-arity מציין כמה מופעים חוזרים של האוסף הזה יופיעו בכל דוח שאליו הוא מצורף. המזהה מתאר את סוג הקיבוץ שמיוצג על ידי האוסף. לדוגמה, למסך מגע שיכול לדווח על עד 2 אצבעות בו-זמנית עשויה להיות אוסף עם הקואורדינטות X ו-Y, אריטמיות של 2 ומזהה INPUT_COLLECTION_USAGE_TOUCHSCREEN. כל מזהה יכול להופיע רק פעם אחת בדוח נתון.

ההגדרה נמצאת בשורה 455 בקובץ input.h .

void(* input_report_definition_declare_usage_int)( input_host_t *host, input_report_definition_t *report, input_collection_id_t id, input_usage_t usage, int32_t min, int32_t max, float resolution)

מגדירים שימוש ב-int עם המאפיינים הנתונים. הדוח והאוסף מגדירים איפה מתבצעת ההצהרה על השימוש.

ההגדרה נמצאת בשורה 462 בקובץ input.h .

void(* input_report_definition_declare_usages_bool)( input_host_t *host, input_report_definition_t *report, input_collection_id_t id, input_usage_t *usage, size_t usage_count)

הצהרת קבוצה של שימושים בוליאנים עם המאפיינים הנתונים. בדוח ובאוסף מוגדר המיקום שבו מתבצעת ההצהרה על אופן השימוש.

ההגדרה מופיעה בשורה 470 בקובץ input.h .

void(* input_report_set_usage_bool)( input_host_t *host, input_report_t *r, input_collection_id_t id, input_usage_t usage, bool value, int32_t arity_index)

הוספת ערך בוליאני לשימוש בדוח.

ההגדרה נמצאת בשורה 499 בקובץ input.h .

void(* input_report_set_usage_int)( input_host_t *host, input_report_t *r, input_collection_id_t id, input_usage_t usage, int32_t value, int32_t arity_index)

הוספת ערך שימוש מסוג int לדוח.

ההגדרה נמצאת בשורה 493 בקובץ input.h .

input_device_handle_t *(* register_device)( input_host_t *host, input_device_identifier_t *id, input_device_definition_t *d)

רישום של הגדרה נתונה של מכשיר קלט. כך המארח יקבל הודעה על חיבור של מכשיר קלט, ויתקבל תיאור של כל היכולות שלו.

ההגדרה מופיעה בשורה 479 בקובץ input.h .

void(* report_event)( input_host_t *host, input_device_handle_t *d, input_report_t *report)

ההגדרה מופיעה בשורה 502 בקובץ input.h .

void(* unregister_device)( input_host_t *host, input_device_handle_t *handle)

ביטול הרישום של המכשיר הנתון

ההגדרה מופיעה בשורה 483 בקובץ input.h .

התיעוד של המבנה הזה נוצר מהקובץ הבא:
  • hardware/libhardware/include/hardware/ input.h