Skip to content

wasapisrc: Documentation for "device" property is incorrect, description is wrong

Gstreamer's documentation of the "device" property is incorrect here: https://gstreamer.freedesktop.org/documentation/wasapi/wasapisrc.html?gi-language=c

The description is incorrect: WASAPI playback device as a GUID string

  • It is not a GUID
  • It is not a "playback" device

Please change the description to: The id of the WASAPI device, as provided by IMMDevice::GetID

background

The source code (e.g. gst_wasapi_util_get_device_client) shows that you are using the IMMDevice API. Therefore, devices are identified by the string that comes out of the IMMDevice::GetID method. As described here: "The string format is undefined and might change"

On my Windows machine, I have 3 audio capture devices, and 3 id strings that look like this:

{0.0.1.00000000}.{7c404c56-047d-4eed-a066-080f3822ba51}
{0.0.1.00000000}.{7c56cd38-5cec-4307-989c-ad15d9706b01}
{0.0.1.00000000}.{f2f757be-cb31-4cb1-ae49-4883e1cd299a}

The strings above are clearly not GUIDs.

testing

Commands (like the following) are working as advertised from my Windows machine.

gst-launch-1.0 wasapisrc device="{0.0.1.00000000}.{7c404c56-047d-4eed-a066-080f3822ba51}" ! ...