3. HAL层接口定义：camera3_callback_ops_t结构体详解、process_capture_result函数签名、notify函数的作用

在Camera HAL3架构中，Result回调机制是连接HAL层与Camera Framework的核心桥梁。HAL层通过一组预定义的回调函数指针，将捕获结果、错误事件、快门事件等异步通知给上层。这组回调函数被封装在 camera3_callback_ops_t 结构体中，由Framework在初始化时注册给HAL设备。

3.1 camera3_callback_ops_t 结构体详解

camera3_callback_ops_t 定义在 hardware/libhardware/include/hardware/camera3.h 中，是HAL层向上层发送异步消息的唯一通道。该结构体包含三个核心函数指针，分别对应三种不同类型的回调事件。

结构体定义如下：

typedef struct camera3_callback_ops {
    /**
     * process_capture_result: 向Framework返回一次捕获请求的结果。
     * 包含输出buffer、metadata、部分结果标记等。
     */
    void (*process_capture_result)(const struct camera3_callback_ops *,
            const camera3_capture_result_t *result);

    /**
     * notify: 向Framework发送异步事件通知。
     * 包括快门事件（SHUTTER）、错误事件（ERROR）等。
     */
    void (*notify)(const struct camera3_callback_ops *,
            const camera3_notify_msg_t *msg);

    /**
     * notify_physically: (Android 9+) 用于物理相机子设备的独立事件通知。
     * 仅在逻辑多摄像头场景下使用。
     */
    void (*notify_physically)(const struct camera3_callback_ops *,
            const camera3_notify_msg_t *msg);
} camera3_callback_ops_t;

3.2 process_capture_result 函数签名与语义

process_capture_result 是HAL层向Framework返回捕获结果的核心回调。每次调用对应一个或多个已完成的捕获请求，携带输出buffer、结果metadata以及部分结果标记。

void (*process_capture_result)(const struct camera3_callback_ops *ops,
                               const camera3_capture_result_t *result);

camera3_capture_result_t 结构体关键字段：

3.3 notify 函数的作用

notify 回调用于发送异步事件通知，与 process_capture_result 独立并行。它主要处理两类事件：快门事件和错误事件。

void (*notify)(const struct camera3_callback_ops *ops,
               const camera3_notify_msg_t *msg);

camera3_notify_msg_t 是一个联合体，根据 type 字段区分事件类型：

快门事件（SHUTTER） 是HAL必须保证在第一个output buffer返回之前发送的事件，用于通知Framework传感器曝光开始的时间戳。该时间戳是图像稳定、闪光灯同步、3A算法等模块的关键输入。

typedef struct camera3_shutter_msg {
    uint32_t frame_number;      // 请求帧序号
    uint64_t timestamp;         // 曝光开始时间戳（纳秒）
} camera3_shutter_msg_t;

错误事件（ERROR） 用于报告HAL层发生的各类异常情况。Framework根据错误类型决定后续处理策略：

3.4 回调调用时序与生命周期

理解三个回调函数的调用时序对于正确实现HAL至关重要。以下是一个典型请求的生命周期：

1. 请求提交：Framework调用 process_capture_request 提交请求，HAL开始处理。
2. 快门事件：传感器开始曝光时，HAL调用 notify 发送SHUTTER事件，携带曝光时间戳。
3. 部分结果（可选）：HAL调用 process_capture_result 返回部分metadata（partial_result > 0），可同时返回已完成的buffer。
4. 最终结果：HAL调用 process_capture_result 返回最终metadata（partial_result = 0），所有剩余buffer必须在此次或之前返回。
5. 错误处理：如果处理过程中发生错误，HAL在任意时刻调用 notify 发送ERROR事件，然后继续返回已完成的buffer。