acquireFrame

Takes the newest rendered frame from the session's texture ring, if one is ready.

Older frames that you haven't acquired are dropped, and the session can render over a frame before you acquire it. While you hold a frame in every texture of the ring, new frames wait until you release one. When no frame is ready, it succeeds and writes the null handle.

See mln_render_session_acquire_frame in the C API reference.

Errors:

• Status.UNSUPPORTED when the session lacks RenderSessionCapabilityFlag.FRAME_ACQUISITION.

• Status.TARGET_LOST or Status.NATIVE_ERROR, as RenderSessionSnapshot.failureStatus reports, when the session has failed.

• Status.INVALID_STATE when you detached, abandoned, released, or disposed the session.