wasapi2: Rewrite plugin and implement audioringbuffer subclass
authorSeungha Yang <seungha@centricular.com>
Mon, 10 May 2021 11:45:28 +0000 (20:45 +0900)
committerSeungha Yang <seungha@centricular.com>
Tue, 8 Jun 2021 10:39:27 +0000 (19:39 +0900)
commita8ec40c850b678272c279ea4914390ac7abc8408
treeec6fe6075e6ab927876046f3c633c8a25a11c262
parent4b42671c9924674e77b8b35f3b22abab651e8bb3
wasapi2: Rewrite plugin and implement audioringbuffer subclass

... based on MediaFoundation work queue API.

By this commit, wasapi2 plugin will make use of pull mode scheduling
with audioringbuffer subclass.
There are several drawbacks of audiosrc/audiosink subclassing
(not audiobasesrc/audiobasesink) for WASAPI API, which are:
* audiosrc/audiosink classes try to set high priority to
  read/write thread via MMCSS (Multimedia Class Scheduler Service)
  but it's not allowed in case of UWP application.
  In order to use MMCSS in UWP, application should use MediaFoundation
  work queue indirectly.
  Since audiosrc/audiosink scheduling model is not compatible with
  MediaFoundation's work queue model, audioringbuffer subclassing
  is required.
* WASAPI capture device might report larger packet size than expected
  (i.e., larger frames we can read than expected frame size per period).
  Meanwhile, in any case, application should drain all packets at that moment.
  In order to handle the case, wasapi/wasapi2 plugins were making use of
  GstAdapter which is obviously sub-optimal because it requires additional
  memory allocation and copy.
  By implementing audioringbuffer subclassing, we can avoid such inefficiency.

In this commit, all the device read/write operations will be moved
to newly implemented wasapi2ringbuffer class and
existing wasapi2client class will take care of device enumeration
and activation parts only.

Part-of: <https://gitlab.freedesktop.org/gstreamer/gst-plugins-bad/-/merge_requests/2306>
13 files changed:
sys/wasapi2/gstwasapi2client.cpp
sys/wasapi2/gstwasapi2client.h
sys/wasapi2/gstwasapi2device.c
sys/wasapi2/gstwasapi2ringbuffer.cpp [new file with mode: 0644]
sys/wasapi2/gstwasapi2ringbuffer.h [new file with mode: 0644]
sys/wasapi2/gstwasapi2sink.c
sys/wasapi2/gstwasapi2sink.h
sys/wasapi2/gstwasapi2src.c
sys/wasapi2/gstwasapi2src.h
sys/wasapi2/gstwasapi2util.c
sys/wasapi2/gstwasapi2util.h
sys/wasapi2/meson.build
sys/wasapi2/plugin.c