flexaudio-os-windows 0.2.0

Windows system and per-process audio capture backend (WASAPI loopback) for flexaudio.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36

//! flexaudio-os-windows — Windows バックエンド: WASAPI ループバック / プロセス
//! ループバック（windows-rs 0.54, Win11+）。
//!
//! 2 つの [`CaptureBackend`](flexaudio_core::backend::CaptureBackend) を提供する:
//!
//! - [`WasapiSystemBackend`] — render endpoint の古典 loopback
//!   （`AUDCLNT_STREAMFLAGS_LOOPBACK`）でシステム音声出力（そのエンドポイントへ流れている
//!   ミックス）を録る。`device_id` で出力エンドポイントを選べる（`None` で既定）。Linux の
//!   [`PwSystemBackend`](../flexaudio_os_linux) 相当。出力エンドポイントの一覧は
//!   [`list_output_devices`] で取れる。
//! - [`WasapiProcessBackend`] — `ActivateAudioInterfaceAsync` + プロセスループバック
//!   （`AUDIOCLIENT_ACTIVATION_PARAMS`）で特定 PID（そのプロセスツリー）の音声を録る。
//!   `exclude_self` で「対象ツリーを除く全システム音」へ反転する。
//!
//! # `!Send` 回避
//!
//! WASAPI の `IAudioClient` 等の COM インターフェイスは `!Send` だが、コア契約
//! [`CaptureBackend`] は `Send` を要求する。COM の初期化からキャプチャ、破棄までを専用
//! スレッド 1 本の上で完結させ、バックエンド構造体が持つのは `Send` なものだけ（停止フラグ
//! [`AtomicBool`] / [`JoinHandle`] / キャッシュ済みフォーマット）にする。COM インター
//! フェイスはスレッド境界を跨がない。cpal / PipeWire backend と同じ作り。
//!
//! # 非 Windows
//!
//! `#![cfg(target_os = "windows")]` で非 Windows では空コンパイルになり、`windows`
//! 依存も `Cargo.toml` の `target.'cfg(...windows)'` セクションでしか引かれない。

#![cfg(target_os = "windows")]
#![warn(missing_docs)]

mod common;
mod process;
mod system;

pub use process::WasapiProcessBackend;
pub use system::{list_output_devices, WasapiSystemBackend};