wasapi 0.24.0

Bindings for the Wasapi API on Windows
Documentation

Wasapi bindings for Rust

The aim of this crate is to provide easy and safe access to the Wasapi API for audio playback and capture.

The presented API is all safe Rust, but structs and functions closely follow the original Windows API.

For details on how to use Wasapi, please see the Windows documentation.

Sponsor: Recall.ai - API for desktop recording

If you’re looking for a hosted desktop recording API, consider checking out Recall.ai, an API that records Zoom, Google Meet, Microsoft Teams, in-person meetings, and more.

Supported functionality

The following is a selection of the functionality currently available in the library:

  • Audio playback and capture
  • Shared and exclusive modes
  • Event-driven and polled buffering
  • Loopback capture
  • Notifications for volume change, device disconnect etc
  • Notifications when devices are added or removed, or when the default device changes
  • …and additional features beyond this list

Included examples

Example Description
playsine Plays a sine wave in shared mode on the default output device.
playsine_events Similar to playsine but also listens to notifications.
playsine_poll Similar to playsine but uses polling instead of event driven timing mode.
playnoise_exclusive Plays white noise in exclusive mode on the default output device. Shows how to handle HRESULT errors.
playnoise_exclusive_poll Similar to playnoise_exclusive but uses polling instead of event driven timing mode.
loopback Shows how to simultaneously capture and render sound, with separate threads for capture and render.
record Records audio from the default device, and saves the raw samples to a file.
devices Lists all available audio devices and displays the default devices.
processes Lists all audio devices and the processes that are using them, with the peak level of each session.
record_application Records audio from a single application, and saves the raw samples to a file.
aec Captures audio with Acoustic Echo Cancellation (AEC) enabled and saves the raw data to a file.
device_notifications Listens for devices being added, removed or changed, and for changes of the default device.