V19ApiChanges

Changes to the public PortAudio API for V19-M1 development milestone

The V19-M1 development milestone (which is now under way) will include a number of minor changes to the public PortAudio API and binary interface. This page documents those changes.

Our intention is to make source-level compatibility API changes in the V19-M1 iteration, ABI changes (breaking binary compatibility) in the V19-M2 iteration and then, after that, to only make internal changes until the final V19 release.

You can review all tickets scheduled for V19-M2 here: https://github.com/PortAudio/portaudio/issues

Changes made

• One ASIO-specific function will be renamed: . #111 rename PaAsio_GetAvailableLatencyValues => PaAsio_GetAvailableBufferSizes

Changes planned

The following public-visible changes are planned during the V19-M2 development iteration:

• The host-specific extension mechanism will be revised, this relates mainly to PortMixer interoperability. See: . #169 Portaudio should expose host API specific stream information

• We may break binary compatibility to implement structure alignment clarifications: . #58 API calling convention and pack but also because we will be removing some redundant fields: . #172 Remove structVersion field from PaHostApiInfo, PaDeviceInfo and PaStreamInfo

• We will rename one structure field, which will break source compatibility if you are using it: . #92 rename PaStreamParameters::hostApiSpecificStreamInfo to hostApiSpecificStreamParameters

• We may change/extend the library version API. This has not yet been discussed in detail: . #173 Improved API library version API

See also ticket: #174 Meta ticket: ABI/API changes before V19 final release