Struct RecordingHandle 

pub struct RecordingHandle { /* private fields */ }

录制句柄（用于控制和监控）

Drop 语义

当 RecordingHandle 被丢弃时：

• ✅ 自动 flush 缓冲区中的数据
• ✅ 自动关闭接收端
• ❌ 不会自动保存文件（需要显式调用 stop_recording()）

Panics

如果在 Drop 时发生 I/O 错误，错误会被静默忽略（Drop 上下文无法处理错误）。 建议始终显式调用 stop_recording() 以获取错误结果。

Implementations

impl RecordingHandle

pub fn frame_count(&self) -> u64

获取当前已录制的帧数（线程安全，无阻塞）

返回

当前已成功录制的帧数

pub fn dropped_count(&self) -> u64

获取当前丢帧数量

pub fn is_stop_requested(&self) -> bool

检查是否已请求停止（用于循环条件判断）

pub fn stop(&self)

手动停止录制（请求停止）

pub fn elapsed(&self) -> Duration

获取录制时长

pub fn output_path(&self) -> &PathBuf

获取输出文件路径

Trait Implementations

impl Drop for RecordingHandle

fn drop(&mut self)

⚠️ Drop 语义：自动清理资源

注意：这里只关闭接收端，不保存文件。 文件保存必须在 stop_recording() 中显式完成。