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)
 

詳細說明

定義位於檔案 input.h 的第 409 行。

欄位說明文件

input_device_definition_t *(* create_device_definition)( input_host_t *host)

分配裝置定義，用於說明裝置的輸入功能。您可以使用裝置定義，註冊任意數量的裝置。

定義位於檔案 input.h 的 424 行。

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)

使用指定屬性建立裝置 ID。這個專屬 ID 應為字串，用於精確識別特定硬體。舉例來說，透過藍牙連線的輸入裝置可以使用 MAC 位址做為專屬 ID。

定義位於檔案 input.h 的 416 行。

input_report_definition_t *(* create_input_report_definition)( input_host_t *host)

請分配輸入報告，讓 HAL 用來向主機通知傳入的輸入事件，或是分配輸出報告，讓主機用來通知 HAL 所需的狀態變更 (例如設定 LED)。

定義位於檔案 input.h 的 431 行。

input_report_definition_t *(* create_output_report_definition)( input_host_t *host)

定義位於檔案 input.h 的 432 行。

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

釋放報表定義。

定義位於檔案 input.h 的 437 行。

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

分配報表，該報表會包含特定報表所述的所有狀態。

定義位於檔案 input.h 的 488 行。

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

將報表附加至指定的輸入裝置。

定義位於檔案 input.h 的 442 行。

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

釋放 input_property_t*。

定義位於檔案 input.h 的 535 行。

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

釋放 input_property_map_t*。

定義位於檔案 input.h 的 540 行。

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

使用指定鍵，擷取裝置的屬性。如果索引鍵不存在，則會傳回 NULL，否則會傳回必須使用 input_free_device_property() 釋放的 input_property_t*。在對應的 input_property_map_t 釋放後使用 input_property_t 是未定義的。

定義位於檔案 input.h 的 517 行。

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 回呼查詢特定屬性。

定義位於檔案 input.h 的 509 行。

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

取得輸入屬性的鍵。如果屬性為空值，則傳回 NULL。傳回的 const char* 由 input_property_t 擁有。

定義位於檔案 input.h 的 524 行。

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

取得輸入屬性的值。如果屬性為空值，則傳回 NULL。傳回的 const char* 由 input_property_t 擁有。

定義位於檔案 input.h 的 530 行。

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

新增具有指定多重度和 ID 的集合。集合會描述一組邏輯上已分組的屬性，例如單指輕觸的 X 和 Y 座標，或是鍵盤上的一組按鍵。arity 會宣告這個集合在附加的報表中重複出現的次數。這個 ID 會說明集合代表的分組類型。舉例來說，如果觸控螢幕可同時回報最多 2 根手指，則集合可能會包含 X 和 Y 座標、2 的次元數，以及 INPUT_COLLECTION_USAGE_TOUCHSCREEN 的 ID。任何 ID 在特定報表中只能出現一次。

定義位於檔案 input.h 的 455 行。

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 用法。報表和集合會定義使用情形的聲明位置。

定義位於檔案 input.h 的 462 行。

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.h 的 470 行。

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)

在報表中新增布林值用量值。

定義位於檔案 input.h 的 499 行。

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 用量值。

定義位於檔案 input.h 的 493 行。

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

註冊指定的輸入裝置定義。這會通知主機已連線的輸入裝置，並提供所有功能的說明。

定義位於檔案 input.h 的 479 行。

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

定義位於檔案 input.h 的 502 行。

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

取消註冊指定裝置

定義位於檔案 input.h 的 483 行。

這個結構體的說明文件是由下列檔案產生：
  • hardware/libhardware/include/hardware/ input.h