#include < nvram.h >

数据字段
struct hw_device_t	常见

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)

详细说明

定义位于文件 nvram.h 的 48 行。

字段文档

struct hw_device_t common

nvram_device 的常用方法。此必须是 nvram_device 的第一个成员，因为此结构的用户会在已知 hw_device_t 引用 nvram_device 的情况下，将 hw_device_t 转换为 nvram_device 指针。

定义位于文件 nvram.h 的 55 行。

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 - 新空间的索引。index - 可以是任何 32 位值，但不得已分配给现有空间。size_in_bytes - 要为该空间分配的字节数。control_list - 要针对该空间强制执行的控制列表。list_size - |control_list| 中的项数。authorization_value - 如果 |control_list| 包含 NV_CONTROL_READ_AUTHORIZATION 和 / 或 NV_CONTROL_WRITE_AUTHORIZATION，则此参数会为这些政策提供授权值（如果同时设置这两个控制，则此值适用于这两个控制）。否则，此值会被忽略，并且可能为 NULL。authorization_value_size - |authorization_value| 中的字节数。

定义位于文件 nvram.h 的 187 行。

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| 中的字节数。

定义位于文件 nvram.h 的 207 行。

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

在下次设备完全重置（即恢复出厂设置，而非重新启动）之前，禁止进一步创建聊天室。对 NV_CreateSpace 的后续调用应返回 NV_RESULT_OPERATION_DISABLED。

device - nvram_device 实例。

定义位于文件 nvram.h 的 219 行。

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| 中的字节数。

定义位于文件 nvram.h 的 317 行。

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| 中的字节数。

定义位于文件 nvram.h 的第 294 行。

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

输出 NVRAM 中未分配的字节数。如果实现不知道可用大小，则可以提供估算值或总大小。

device - nvram_device 实例。available_size - 接收输出。不得为 NULL。

定义位于文件 nvram.h 的 76 行。

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。

定义位于文件 nvram.h 的 87 行。

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

输出可分配的总空间数上限。此值始终至少为 8。如果支持任意数量的空间（仅限可用的 NVRAM 字节），则输出 NV_UNLIMITED_SPACES。

device - nvram_device 实例。num_spaces - 接收输出。不得为 NULL。

定义位于文件 nvram.h 的 99 行。

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

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|。

定义位于文件 nvram.h 的 116 行。

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

输出给定空间的大小（以字节为单位）。

device - nvram_device 实例。index - 空间索引。size - 接收输出。不得为 NULL。

定义位于文件 nvram.h 的 128 行。

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。

定义位于文件 nvram.h 的 65 行。

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 - 如果当前停用了写入操作，则将设置为非零值。read_lock_enabled - 如果当前停用了读取操作，则将设置为非零值。

定义位于文件 nvram.h 的 161 行。

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| 或空间大小中的较小者。

定义位于文件 nvram.h 的 272 行。

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| 中的字节数。

定义位于文件 nvram.h 的 241 行。

此结构体的文档是根据以下文件生成的：

hardware/libhardware/include/hardware/ nvram.h

nvram_device 结构体参考文档

数据字段

详细说明

字段文档