Driver capabilities whose table must outlive every pending image. More...
#include <camera_capture.h>
Data Fields | |
| int(* | acquire )(struct camera_pending *pending, int image_number) |
| Retain one exposure without waiting for its final JPEG publication. | |
| int(* | finish )(struct camera_pending *pending, char *filename, size_t size, const volatile sig_atomic_t *running) |
| Finish the exact acquisition represented by pending. | |
| bool(* | has_capacity )(void) |
| Nonblocking capacity snapshot; acquisition remains the admission authority. | |
| unsigned | max_in_flight |
Detailed Description
Driver capabilities whose table must outlive every pending image.
USHER snapshots the table pointer with the image, not the currently selected camera. This keeps a later backend switch from finishing the wrong job. Acquisition is serialized by the camera owner; finish may overlap later captures. Implementations must synchronize their shared state and bound memory and waits.
Definition at line 73 of file camera_capture.h.
Field Documentation
◆ acquire
| int(* camera_capture_ops::acquire) (struct camera_pending *pending, int image_number) |
Retain one exposure without waiting for its final JPEG publication.
- Parameters
-
[out] pending Ownership record filled by the driver. image_number Original USHER shot number.
- Returns
- Zero with acquired set when pixels are owned; positive for synchronous fallback before any exposure; negative for failure without a duplicate retry.
Definition at line 80 of file camera_capture.h.
◆ finish
| int(* camera_capture_ops::finish) (struct camera_pending *pending, char *filename, size_t size, const volatile sig_atomic_t *running) |
Finish the exact acquisition represented by pending.
- Parameters
-
[in,out] pending Record to release, including admission accounting, on every exit. [out] filename Published filename on success; empty on failure. size Filename capacity including its terminating NUL. running Optional shutdown flag to check during bounded waits.
- Returns
- Zero for a verified published file, negative on failure or cancellation.
- Warning
- Failure is not permission to discard an existing original or recapture using the old pose. Preserve recoverable private files and report the failure.
Definition at line 90 of file camera_capture.h.
◆ has_capacity
| bool(* camera_capture_ops::has_capacity) (void) |
Nonblocking capacity snapshot; acquisition remains the admission authority.
- Returns
- True when another capture may be attempted. NULL means no extra readiness gate.
Definition at line 95 of file camera_capture.h.
◆ max_in_flight
| unsigned camera_capture_ops::max_in_flight |
Per-camera limit, currently 1..2; not a whole-MORA memory budget.
Definition at line 96 of file camera_capture.h.
The documentation for this struct was generated from the following file:
- src/camera_capture.h