uses DirectSound More...

#include <WinAudioDS.h>

Inheritance diagram for HephAudio::Native::WinAudioDS:

Public Member Functions
	WinAudioDS ()

	WinAudioDS (const WinAudioDS &)=delete

WinAudioDS &	operator= (const WinAudioDS &)=delete

	~WinAudioDS ()

void	SetMasterVolume (double volume) override

double	GetMasterVolume () const override

void	InitializeRender (AudioDevice *device, AudioFormatInfo format) override

void	StopRendering () override

void	InitializeCapture (AudioDevice *device, AudioFormatInfo format) override

void	StopCapturing () override

void	GetNativeParams (NativeAudioParams &nativeParams) const override

void	SetNativeParams (const NativeAudioParams &nativeParams) override

void	InitializeRender ()

void	InitializeRender (const AudioChannelLayout &channelLayout, uint32_t sampleRate)

void	InitializeRender (AudioFormatInfo format)

void	InitializeRender (AudioDevice *device, const AudioChannelLayout &channelLayout, uint32_t sampleRate)

void	InitializeCapture ()

void	InitializeCapture (const AudioChannelLayout &channelLayout, uint32_t sampleRate)

void	InitializeCapture (AudioFormatInfo format)

void	InitializeCapture (AudioDevice *device, const AudioChannelLayout &channelLayout, uint32_t sampleRate)

Public Member Functions inherited from HephAudio::Native::WinAudioBase
	WinAudioBase ()

	WinAudioBase (const WinAudioBase &)=delete

WinAudioBase &	operator= (const WinAudioBase &)=delete

virtual	~WinAudioBase ()=default

Public Member Functions inherited from HephAudio::Native::NativeAudio
	NativeAudio ()

	NativeAudio (const NativeAudio &)=delete

NativeAudio &	operator= (const NativeAudio &)=delete

virtual	~NativeAudio ()=default

std::shared_ptr< IAudioDecoder >	GetAudioDecoder () const

void	SetAudioDecoder (std::shared_ptr< IAudioDecoder > pNewDecoder)

std::shared_ptr< IAudioEncoder >	GetAudioEncoder () const

void	SetAudioEncoder (std::shared_ptr< IAudioEncoder > pNewEncoder)

AudioObject *	Play (const std::filesystem::path &filePath)

AudioObject *	Play (const std::filesystem::path &filePath, uint32_t playCount)

AudioObject *	Load (const std::filesystem::path &filePath)

AudioObject *	Load (const std::filesystem::path &filePath, uint32_t playCount)

AudioObject *	CreateAudioObject (const std::string &name, size_t bufferFrameCount, AudioChannelLayout channelLayout, uint32_t sampleRate)

bool	DestroyAudioObject (AudioObject *pAudioObject)

bool	DestroyAudioObject (const Heph::Guid &audioObjectId)

bool	AudioObjectExists (AudioObject *pAudioObject) const

bool	AudioObjectExists (const Heph::Guid &audioObjectId) const

AudioObject *	GetAudioObject (size_t index)

AudioObject *	GetAudioObject (const Heph::Guid &audioObjectId)

AudioObject *	GetAudioObject (const std::string &audioObjectName)

size_t	GetAudioObjectCount () const

void	ResumeCapture ()

void	PauseCapture ()

bool	IsCapturePaused () const

uint32_t	GetDeviceEnumerationPeriod () const

void	SetDeviceEnumerationPeriod (uint32_t deviceEnumerationPeriod_ms)

const AudioFormatInfo &	GetRenderFormat () const

const AudioFormatInfo &	GetCaptureFormat () const

void	InitializeRender ()

void	InitializeRender (const AudioChannelLayout &channelLayout, uint32_t sampleRate)

void	InitializeRender (AudioFormatInfo format)

void	InitializeRender (AudioDevice *device, const AudioChannelLayout &channelLayout, uint32_t sampleRate)

void	InitializeCapture ()

void	InitializeCapture (const AudioChannelLayout &channelLayout, uint32_t sampleRate)

void	InitializeCapture (AudioFormatInfo format)

void	InitializeCapture (AudioDevice *device, const AudioChannelLayout &channelLayout, uint32_t sampleRate)

AudioDevice	GetAudioDeviceById (const std::string &deviceId) const

AudioDevice	GetRenderDevice () const

AudioDevice	GetCaptureDevice () const

AudioDevice	GetDefaultAudioDevice (AudioDeviceType deviceType) const

std::vector< AudioDevice >	GetAudioDevices (AudioDeviceType deviceType) const

Additional Inherited Members
Public Attributes inherited from HephAudio::Native::NativeAudio
Heph::Event	OnAudioDeviceAdded

Heph::Event	OnAudioDeviceRemoved

Heph::Event	OnCapture

Protected Member Functions inherited from HephAudio::Native::WinAudioBase
void	InitializeCOM () const

Protected Member Functions inherited from HephAudio::Native::NativeAudio
void	JoinRenderThread ()

void	JoinCaptureThread ()

void	JoinDeviceThread ()

EncodedAudioBuffer	Mix (uint32_t frameCount)

size_t	GetAOCountToMix () const

virtual double	GetFinalAOVolume (AudioObject *pAudioObject) const

Static Protected Member Functions inherited from HephAudio::Native::WinAudioBase
static AudioFormatInfo	WFX2AFI (const WAVEFORMATEXTENSIBLE &wfx)

static WAVEFORMATEXTENSIBLE	AFI2WFX (const AudioFormatInfo &afi)

static std::string	GetComErrorMessage (HRESULT hr)

Protected Attributes inherited from HephAudio::Native::NativeAudio
std::shared_ptr< IAudioDecoder >	pAudioDecoder

std::shared_ptr< IAudioEncoder >	pAudioEncoder

std::list< AudioObject >	audioObjects

std::vector< AudioDevice >	audioDevices

std::thread::id	mainThreadId

std::thread	renderThread

std::thread	captureThread

std::thread	deviceThread

std::string	renderDeviceId

std::string	captureDeviceId

AudioFormatInfo	renderFormat

AudioFormatInfo	captureFormat

bool	disposing

bool	isRenderInitialized

bool	isCaptureInitialized

bool	isCapturePaused

uint32_t	deviceEnumerationPeriod_ms

std::mutex	audioDevicesMutex

std::recursive_mutex	audioObjectsMutex

Static Protected Attributes inherited from HephAudio::Native::NativeAudio
static constexpr bool	DEVICE_ENUMERATION_FAIL = false

static constexpr bool	DEVICE_ENUMERATION_SUCCESS = true

Detailed Description

uses DirectSound

Constructor & Destructor Documentation

◆ WinAudioDS()

HephAudio::Native::WinAudioDS::WinAudioDS ( )

creates a new instance and initializes it with default values.

◆ ~WinAudioDS()

HephAudio::Native::WinAudioDS::~WinAudioDS ( )

releases the resources and destroys the instance.

Member Function Documentation

◆ SetMasterVolume()

void HephAudio::Native::WinAudioDS::SetMasterVolume ( double volume )

overridevirtual

sets the master volume.

Parameters

volume new master volume.

Important: values above 1 may cause distortion.

Implements HephAudio::Native::NativeAudio.

◆ GetMasterVolume()

double HephAudio::Native::WinAudioDS::GetMasterVolume ( ) const

overridevirtual

gets the master volume.

Implements HephAudio::Native::NativeAudio.

◆ InitializeRender() [1/5]

void HephAudio::Native::WinAudioDS::InitializeRender	(	AudioDevice *	device,
		AudioFormatInfo	format )

overridevirtual

initializes rendering with the provided device and the provided format.

Parameters

device	pointer to the audio render device.
format	render format.

Implements HephAudio::Native::NativeAudio.

◆ StopRendering()

void HephAudio::Native::WinAudioDS::StopRendering ( )

overridevirtual

stops rendering and releases the resources allocated for it.

Implements HephAudio::Native::NativeAudio.

◆ InitializeCapture() [1/5]

void HephAudio::Native::WinAudioDS::InitializeCapture	(	AudioDevice *	device,
		AudioFormatInfo	format )

overridevirtual

initializes capturing with the provided device and the provided format.

Parameters

device	pointer to the audio capture device.
format	capture format.

Implements HephAudio::Native::NativeAudio.

◆ StopCapturing()

void HephAudio::Native::WinAudioDS::StopCapturing ( )

overridevirtual

stops capturing and releases the resources allocated for it.

Implements HephAudio::Native::NativeAudio.

◆ GetNativeParams()

void HephAudio::Native::WinAudioDS::GetNativeParams ( NativeAudioParams & nativeParams ) const

overridevirtual

gets the native API specific parameters.

Implements HephAudio::Native::NativeAudio.

◆ SetNativeParams()

void HephAudio::Native::WinAudioDS::SetNativeParams ( const NativeAudioParams & nativeParams )

overridevirtual

sets the native API specific parameters.

Implements HephAudio::Native::NativeAudio.

◆ InitializeRender() [2/5]

void HephAudio::Native::NativeAudio::InitializeRender ( )

initializes rendering with the default device and default format.

◆ InitializeRender() [3/5]

void HephAudio::Native::NativeAudio::InitializeRender	(	const AudioChannelLayout &	channelLayout,
		uint32_t	sampleRate )

initializes rendering with the default device and the provided format.

Parameters

channelLayout	channel layout of the render format.
sampleRate	sample rate of the render format.

◆ InitializeRender() [4/5]

void HephAudio::Native::NativeAudio::InitializeRender ( AudioFormatInfo format )

initializes rendering with the default device and the provided format.

Parameters

format render format.

◆ InitializeRender() [5/5]

void HephAudio::Native::NativeAudio::InitializeRender	(	AudioDevice *	device,
		const AudioChannelLayout &	channelLayout,
		uint32_t	sampleRate )

initializes rendering with the provided device and the provided format.

Parameters

device	pointer to the audio render device.
channelLayout	channel layout of the render format.
sampleRate	sample rate of the render format.

◆ InitializeCapture() [2/5]

void HephAudio::Native::NativeAudio::InitializeCapture ( )

initializes capturing with the default device and default format.

◆ InitializeCapture() [3/5]

void HephAudio::Native::NativeAudio::InitializeCapture	(	const AudioChannelLayout &	channelLayout,
		uint32_t	sampleRate )

initializes capturing with the default device and the provided format.

Parameters

channelLayout	channel layout of the capture format.
sampleRate	sample rate of the capture format.

◆ InitializeCapture() [4/5]

void HephAudio::Native::NativeAudio::InitializeCapture ( AudioFormatInfo format )

initializes capturing with the default device and the provided format.

Parameters

format capture format.

◆ InitializeCapture() [5/5]

void HephAudio::Native::NativeAudio::InitializeCapture	(	AudioDevice *	device,
		const AudioChannelLayout &	channelLayout,
		uint32_t	sampleRate )

initializes capturing with the provided device and the provided format.

Parameters

device	pointer to the audio capture device.
channelLayout	channel layout of the capture format.
sampleRate	sample rate of the capture format.

Public Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ WinAudioDS()

◆ ~WinAudioDS()

Member Function Documentation

◆ SetMasterVolume()

◆ GetMasterVolume()

◆ InitializeRender() [1/5]

◆ StopRendering()

◆ InitializeCapture() [1/5]

◆ StopCapturing()

◆ GetNativeParams()

◆ SetNativeParams()

◆ InitializeRender() [2/5]

◆ InitializeRender() [3/5]

◆ InitializeRender() [4/5]

◆ InitializeRender() [5/5]

◆ InitializeCapture() [2/5]

◆ InitializeCapture() [3/5]

◆ InitializeCapture() [4/5]

◆ InitializeCapture() [5/5]