#include < nvram.h >

ฟิลด์ข้อมูล
struct hw_device_t	common

nvram_result_t (*	get_total_size_in_bytes )(const struct nvram_device device, uint64_t total_size)

nvram_result_t (*	get_available_size_in_bytes )(const struct nvram_device device, uint64_t available_size)

nvram_result_t (*	get_max_space_size_in_bytes )(const struct nvram_device device, uint64_t max_space_size)

nvram_result_t (*	get_max_spaces )(const struct nvram_device device, uint32_t num_spaces)

nvram_result_t (*	get_space_list )(const struct nvram_device device, uint32_t max_list_size, uint32_t space_index_list, uint32_t *list_size)

nvram_result_t (*	get_space_size )(const struct nvram_device device, uint32_t index, uint64_t size)

nvram_result_t (*	get_space_controls )(const struct nvram_device device, uint32_t index, uint32_t max_list_size, nvram_control_t control_list, uint32_t *list_size)

nvram_result_t (*	is_space_locked )(const struct nvram_device device, uint32_t index, int write_lock_enabled, int *read_lock_enabled)

nvram_result_t (*	create_space )(const struct nvram_device device, uint32_t index, uint64_t size_in_bytes, const nvram_control_t control_list, uint32_t list_size, const uint8_t *authorization_value, uint32_t authorization_value_size)

nvram_result_t (*	delete_space )(const struct nvram_device device, uint32_t index, const uint8_t authorization_value, uint32_t authorization_value_size)

nvram_result_t (*	disable_create )(const struct nvram_device *device)

nvram_result_t (*	write_space )(const struct nvram_device device, uint32_t index, const uint8_t buffer, uint64_t buffer_size, const uint8_t *authorization_value, uint32_t authorization_value_size)

nvram_result_t (*	read_space )(const struct nvram_device device, uint32_t index, uint64_t num_bytes_to_read, const uint8_t authorization_value, uint32_t authorization_value_size, uint8_t buffer, uint64_t bytes_read)

nvram_result_t (*	enable_write_lock )(const struct nvram_device device, uint32_t index, const uint8_t authorization_value, uint32_t authorization_value_size)

nvram_result_t (*	enable_read_lock )(const struct nvram_device device, uint32_t index, const uint8_t authorization_value, uint32_t authorization_value_size)

คำอธิบายโดยละเอียด

คําจํากัดความที่บรรทัด 48 ของไฟล์ nvram.h .

เอกสารประกอบในสนาม

struct hw_device_t common

วิธีการทั่วไปของ nvram_device ข้อมูลนี้ ต้อง เป็นสมาชิกแรกของ nvram_device เนื่องจากผู้ใช้โครงสร้างนี้จะแคสต์ hw_device_t เป็น nvram_device พอยน์เตอร์ในบริบทที่ทราบว่า hw_device_t อ้างอิงถึง nvram_device

คําจํากัดความที่บรรทัด 55 ของไฟล์ nvram.h .

nvram_result_t (* create_space)(const struct nvram_device *device, uint32_t index, uint64_t size_in_bytes, const nvram_control_t *control_list, uint32_t list_size, const uint8_t *authorization_value, uint32_t authorization_value_size)

สร้างพื้นที่ทำงานใหม่ที่มีดัชนี ขนาด การควบคุม และค่าการให้สิทธิ์ที่ระบุ

device - อินสแตนซ์ nvram_device index - ดัชนีสำหรับพื้นที่ใหม่ ดัชนีอาจเป็นค่า 32 บิตใดก็ได้ แต่ต้องไม่ได้กำหนดให้กับพื้นที่ที่มีอยู่แล้ว size_in_bytes - จำนวนไบต์ที่จะจัดสรรสำหรับพื้นที่ทำงาน control_list - อาร์เรย์ของการควบคุมที่จะบังคับใช้กับพื้นที่ทำงาน list_size - จำนวนรายการใน |control_list| authorization_value - หาก |control_list| มี NV_CONTROL_READ_AUTHORIZATION และ / หรือ NV_CONTROL_WRITE_AUTHORIZATION พารามิเตอร์นี้จะระบุค่าการให้สิทธิ์สำหรับนโยบายเหล่านี้ (หากตั้งค่าการควบคุมทั้ง 2 รายการ ค่านี้จะมีผลกับทั้ง 2 รายการ) มิเช่นนั้น ระบบจะละเว้นค่านี้และค่าอาจเป็น NULL authorization_value_size - จํานวนไบต์ใน |authorization_value|

คําจํากัดความที่บรรทัด 187 ของไฟล์ nvram.h .

nvram_result_t (* delete_space)(const struct nvram_device *device, uint32_t index, const uint8_t *authorization_value, uint32_t authorization_value_size)

ลบพื้นที่ทำงาน

device - อินสแตนซ์ nvram_device index - ดัชนีของพื้นที่ทำงาน authorization_value - หากพื้นที่ทำงานมีนโยบาย NV_CONTROL_WRITE_AUTHORIZATION พารามิเตอร์นี้จะระบุค่าการให้สิทธิ์ มิเช่นนั้น ระบบจะละเว้นค่านี้และค่าอาจเป็น NULL authorization_value_size - จํานวนไบต์ใน |authorization_value|

คําจํากัดความที่บรรทัด 207 ของไฟล์ nvram.h .

nvram_result_t (* disable_create)(const struct nvram_device *device)

ปิดใช้การสร้างพื้นที่ทำงานเพิ่มเติมจนกว่าจะมีการรีเซ็ตอุปกรณ์ครั้งถัดไป (หมายถึงรีเซ็ตเป็นค่าเริ่มต้น ไม่ใช่รีบูต) การเรียกใช้ NV_CreateSpace ครั้งต่อๆ ไปควรแสดงผล NV_RESULT_OPERATION_DISABLED

device - อินสแตนซ์ nvram_device

คําจํากัดความที่บรรทัด 219 ของไฟล์ nvram.h .

nvram_result_t (* enable_read_lock)(const struct nvram_device *device, uint32_t index, const uint8_t *authorization_value, uint32_t authorization_value_size)

เปิดใช้การล็อกระดับอ่านสำหรับพื้นที่ทำงานที่ระบุตามนโยบาย หากพื้นที่ทำงานไม่ได้ตั้งค่า NV_CONTROL_BOOT_READ_LOCK ไว้ ฟังก์ชันนี้จะไม่มีผลและอาจแสดงข้อผิดพลาด

device - อินสแตนซ์ nvram_device index - ดัชนีของพื้นที่ทำงาน authorization_value - หากพื้นที่ทำงานมีนโยบาย NV_CONTROL_READ_AUTHORIZATION พารามิเตอร์นี้จะระบุค่าการให้สิทธิ์ (โปรดทราบว่าคุณไม่จำเป็นต้องมีสิทธิ์การเขียนเพื่อล็อกไฟล์ไว้สำหรับการอ่าน การล็อกระดับอ่านมีความผันผวนเสมอ) มิเช่นนั้น ระบบจะละเว้นค่านี้และค่าอาจเป็น NULL authorization_value_size - จํานวนไบต์ใน |authorization_value|

คําจํากัดความที่บรรทัด 317 ของไฟล์ nvram.h .

nvram_result_t (* enable_write_lock)(const struct nvram_device *device, uint32_t index, const uint8_t *authorization_value, uint32_t authorization_value_size)

เปิดใช้การล็อกการเขียนสำหรับพื้นที่ทำงานที่ระบุตามนโยบาย หากพื้นที่ทำงานไม่ได้ตั้งค่า NV_CONTROL_PERSISTENT_WRITE_LOCK หรือ NV_CONTROL_BOOT_WRITE_LOCK ไว้ ฟังก์ชันนี้จะไม่มีผลและอาจแสดงข้อผิดพลาด

device - อินสแตนซ์ nvram_device index - ดัชนีของพื้นที่ทำงาน authorization_value - หากพื้นที่ทำงานมีนโยบาย NV_CONTROL_WRITE_AUTHORIZATION พารามิเตอร์นี้จะระบุค่าการให้สิทธิ์ มิเช่นนั้น ระบบจะละเว้นค่านี้และค่าอาจเป็น NULL authorization_value_size - จํานวนไบต์ใน |authorization_value|

คําจํากัดความที่บรรทัด 294 ของไฟล์ nvram.h .

nvram_result_t (* get_available_size_in_bytes)(const struct nvram_device *device, uint64_t *available_size)

แสดงผลจำนวนไบต์ที่ยังไม่ได้จัดสรรใน NVRAM หากการติดตั้งใช้งานไม่ทราบขนาดที่ใช้ได้ ระบบอาจแสดงค่าประมาณหรือขนาดทั้งหมด

device - อินสแตนซ์ nvram_device available_size - รับเอาต์พุต ต้องไม่เป็น NULL

คําจํากัดความที่บรรทัด 76 ของไฟล์ nvram.h .

nvram_result_t (* get_max_space_size_in_bytes)(const struct nvram_device *device, uint64_t *max_space_size)

แสดงผลจํานวนไบต์สูงสุดที่สามารถจัดสรรสําหรับพื้นที่เก็บข้อมูลเดียว ซึ่งจะมีค่าอย่างน้อย 32 เสมอ หากการติดตั้งใช้งานไม่ได้จํากัดขนาดสูงสุด ระบบอาจระบุขนาดทั้งหมด

device - อินสแตนซ์ nvram_device max_space_size - รับเอาต์พุต ต้องไม่เป็น NULL

คําจํากัดความที่บรรทัด 87 ของไฟล์ nvram.h .

nvram_result_t (* get_max_spaces)(const struct nvram_device *device, uint32_t *num_spaces)

แสดงผลจํานวนพื้นที่ทั้งหมดสูงสุดที่อาจจัดสรรได้ ซึ่งจะมีค่าอย่างน้อย 8 เสมอ แสดงผล NV_UNLIMITED_SPACES หากระบบรองรับพื้นที่ทำงานจำนวนเท่าใดก็ได้ (จำกัดเฉพาะไบต์ NVRAM ที่มี)

device - อินสแตนซ์ nvram_device num_spaces - รับเอาต์พุต ต้องไม่เป็น NULL

คําจํากัดความที่บรรทัด 99 ของไฟล์ nvram.h .

nvram_result_t (* get_space_controls)(const struct nvram_device *device, uint32_t index, uint32_t max_list_size, nvram_control_t *control_list, uint32_t *list_size)

แสดงรายการการควบคุมที่เชื่อมโยงกับพื้นที่ทำงานที่ระบุ

คําจํากัดความที่บรรทัด 144 ของไฟล์ nvram.h

nvram_result_t (* get_space_list)(const struct nvram_device *device, uint32_t max_list_size, uint32_t *space_index_list, uint32_t *list_size)

แสดงรายการดัชนีพื้นที่ทำงานที่สร้าง หาก |max_list_size| เป็น 0 ระบบจะป้อนข้อมูลเฉพาะ |list_size|

คําจํากัดความที่บรรทัด 116 ของไฟล์ nvram.h .

nvram_result_t (* get_space_size)(const struct nvram_device *device, uint32_t index, uint64_t *size)

แสดงผลขนาดของพื้นที่หนึ่งๆ เป็นไบต์

device - อินสแตนซ์ nvram_device index - ดัชนีพื้นที่ทำงาน size - รับเอาต์พุต ต้องไม่เป็น NULL

คําจํากัดความที่บรรทัด 128 ของไฟล์ nvram.h .

nvram_result_t (* get_total_size_in_bytes)(const struct nvram_device *device, uint64_t *total_size)

แสดงผลจํานวนไบต์ทั้งหมดที่ใช้ได้ใน NVRAM ซึ่งจะมีค่าอย่างน้อย 2048 เสมอ หากการติดตั้งใช้งานไม่ทราบขนาดทั้งหมด ระบบอาจแสดงค่าประมาณหรือ 2048

device - อินสแตนซ์ nvram_device total_size - รับเอาต์พุต ต้องไม่เป็น NULL

คําจํากัดความที่บรรทัด 65 ของไฟล์ nvram.h .

nvram_result_t (* is_space_locked)(const struct nvram_device *device, uint32_t index, int *write_lock_enabled, int *read_lock_enabled)

แสดงผลว่าพื้นที่ทำงานที่ระบุเปิดใช้ล็อกหรือไม่ เมื่อเปิดใช้การล็อก ระบบจะปิดใช้การดำเนินการดังกล่าว และพยายามดำเนินการดังกล่าวจะส่งผลให้ NV_RESULT_OPERATION_DISABLED

device - อินสแตนซ์ nvram_device index - ดัชนีพื้นที่ทำงาน write_lock_enabled - ระบบจะตั้งค่าเป็นค่าที่ไม่ใช่ 0 เฉพาะในกรณีที่การดําเนินการเขียนปิดอยู่ read_lock_enabled - ระบบจะตั้งค่าเป็นค่าที่ไม่ใช่ 0 เฉพาะในกรณีที่การดําเนินการอ่านปิดอยู่

คําจํากัดความที่บรรทัด 161 ของไฟล์ nvram.h .

nvram_result_t (* read_space)(const struct nvram_device *device, uint32_t index, uint64_t num_bytes_to_read, const uint8_t *authorization_value, uint32_t authorization_value_size, uint8_t *buffer, uint64_t *bytes_read)

อ่านเนื้อหาของพื้นที่ทำงาน หากไม่เคยมีการเขียนลงในพื้นที่นี้ ข้อมูลที่อ่านได้ทั้งหมดจะเป็น 0x00

device - อินสแตนซ์ nvram_device index - ดัชนีพื้นที่เก็บข้อมูล num_bytes_to_read - จํานวนไบต์ที่จะอ่าน |buffer| ต้องมีขนาดมากพอที่จะเก็บไบต์จํานวนนี้ได้ หากจำนวนนี้มากกว่าขนาดของพื้นที่ทำงาน ระบบจะอ่านพื้นที่ทำงานทั้งหมด หากค่านี้น้อยกว่าขนาดของพื้นที่ทำงาน ระบบจะอ่านไบต์แรกในพื้นที่ทำงาน authorization_value - หากพื้นที่ทำงานมีนโยบาย NV_CONTROL_READ_AUTHORIZATION พารามิเตอร์นี้จะระบุค่าการให้สิทธิ์ ไม่เช่นนั้น ระบบจะละเว้นค่านี้และค่าอาจเป็น NULL authorization_value_size - จํานวนไบต์ใน |authorization_value| buffer - รับข้อมูลที่อ่านจากพื้นที่ทำงาน ต้องมีขนาดอย่างน้อย |num_bytes_to_read| ไบต์ bytes_read - จํานวนไบต์ที่อ่าน หากระบบแสดงผล NV_RESULT_SUCCESS ระบบจะตั้งค่านี้เป็นค่าที่น้อยกว่าระหว่าง |num_bytes_to_read| หรือขนาดของพื้นที่ว่าง

คําจํากัดความที่บรรทัด 272 ของไฟล์ nvram.h .

nvram_result_t (* write_space)(const struct nvram_device *device, uint32_t index, const uint8_t *buffer, uint64_t buffer_size, const uint8_t *authorization_value, uint32_t authorization_value_size)

เขียนเนื้อหาของพื้นที่ทำงาน หากพื้นที่ทำงานได้รับการกำหนดค่าด้วย NV_CONTROL_WRITE_EXTEND ระบบจะใช้ข้อมูลอินพุตเพื่อขยายข้อมูลปัจจุบัน

device - อินสแตนซ์ nvram_device index - ดัชนีพื้นที่เก็บข้อมูล buffer - ข้อมูลที่จะเขียน buffer_size - จํานวนไบต์ใน |buffer| หากน้อยกว่าขนาดของพื้นที่เก็บข้อมูล ระบบจะตั้งค่าไบต์ที่เหลือเป็น 0x00 หากมีขนาดใหญ่กว่าพื้นที่ทำงาน ระบบจะแสดงผล NV_RESULT_INVALID_PARAMETER authorization_value - หากพื้นที่ทำงานมีนโยบาย NV_CONTROL_WRITE_AUTHORIZATION พารามิเตอร์นี้จะระบุค่าการให้สิทธิ์ มิเช่นนั้น ระบบจะละเว้นค่านี้และค่าอาจเป็น NULL authorization_value_size - จํานวนไบต์ใน |authorization_value|

คําจํากัดความที่บรรทัด 241 ของไฟล์ nvram.h .

เอกสารประกอบสำหรับโครงสร้างนี้สร้างขึ้นจากไฟล์ต่อไปนี้

hardware/libhardware/include/hardware/ nvram.h

ข้อมูลอ้างอิง Struct nvram_device

ฟิลด์ข้อมูล

คำอธิบายโดยละเอียด

เอกสารประกอบในสนาม