Trait CaptureBackend

Source

pub trait CaptureBackend: Send {
    // Required methods
    fn native_format(&self) -> (u32, u16);
    fn start(&mut self, sink: RawSink) -> Result<()>;
    fn stop(&mut self);
}

Expand description

OS 固有キャプチャバックエンドが実装するトレイト。

facade は native_format でネイティブフォーマットを取得して Normalizer を構成し、start に RawSink を渡してキャプチャを開始する。バックエンドは自身の RT コールバック内で sink.push(...) を呼ぶ。

Stream::open に Box<dyn CaptureBackend> を渡せば独自 backend を差し込める。

独自 backend を実装するときに守ること:

キャプチャスレッド / RT コールバックで panic させない（panic するとキャプチャが静かに止まりうる）。
RT コールバックからの RawSink::push は RT 安全に呼ぶ（ヒープ確保・ロック・ブロッキング・システムコールなし。詳細は RawSink::push を参照）。
start / stop を冪等にする（動作中の二重 start は no-op で Ok、未起動の stop も no-op）。