dx::coreaudio::device< desc_t, preference_t, stream_t, group_t, _hosted >::mirror Struct Reference

a hosted device's transport settings' mirror (dx::stream::settings): a promoted property of the pod, born with the counterpart's property, the setting mapped to its selector - as service::client::device::mirror over the pipe More...

#include <dx_coreaudio_device.h>

Inheritance diagram for dx::coreaudio::device< desc_t, preference_t, stream_t, group_t, _hosted >::mirror:

Collaboration diagram for dx::coreaudio::device< desc_t, preference_t, stream_t, group_t, _hosted >::mirror:

Public Types
typedef std::unique_lock< mutex_t >	lock_t
typedef std::mutex	mutex_t
typedef coreaudio::promoted::property< uint32_t, ::CFNumberRef >	super
typedef uint32_t	value_t

Public Member Functions
void	commit (lock_t &&lock, const value_t &value)
	the server's answer: the value stands, the transition ends and the listeners are told - outside the lock, so a listener may read the promoted back
	mirror (device &device, dx::stream::setting setting)
	operator bool () const noexcept
	operator const value_t & ()
value_t	operator++ (int) noexcept
promoted &	operator+= (const value_t &value) noexcept
value_t	operator-- (int) noexcept
promoted &	operator-= (const value_t &value) noexcept
const value_t &	operator-> ()
bool	operator== (const value_t &value)

Public Attributes
bool	initialized
listen< std::function< void(const uint32_t &)> >	listen
std::function< void(lock_t &&, const value_t &, const value_t &)>	server
	\ indicate the value is in transition - does not have the new value yet
bool	transient
	\ indicate the value has been initialized

Static Public Attributes
static constexpr ::AudioObjectPropertySelector	selectors [] = {coreaudio::property::pod::transport::sync_strategy, coreaudio::property::pod::transport::safety_offset_out, coreaudio::property::pod::transport::safety_offset_in}

Protected Attributes
store	backing_store
listener< decltype(promoted::listen)>	listener
value_t	value

Detailed Description

template<typename desc_t = dx::virtuel::stream::desc, typename preference_t = cf::preference, template< typename ... > typename stream_t = dx::stream::stream, template< typename ... > typename group_t = group, bool _hosted = false>
struct dx::coreaudio::device< desc_t, preference_t, stream_t, group_t, _hosted >::mirror

a hosted device's transport settings' mirror (dx::stream::settings): a promoted property of the pod, born with the counterpart's property, the setting mapped to its selector - as service::client::device::mirror over the pipe

Member Typedef Documentation

lock_t

typedef std::unique_lock<mutex_t> dx::promoted< uint32_t >::lock_t

inherited

mutex_t

typedef std::mutex dx::promoted< uint32_t >::mutex_t

inherited

super

template<typename desc_t = dx::virtuel::stream::desc, typename preference_t = cf::preference, template< typename ... > typename stream_t = dx::stream::stream, template< typename ... > typename group_t = group, bool _hosted = false>

typedef coreaudio::promoted::property<uint32_t, ::CFNumberRef> dx::coreaudio::device< desc_t, preference_t, stream_t, group_t, _hosted >::mirror::super

value_t

typedef uint32_t dx::promoted< uint32_t >::value_t

inherited

Constructor & Destructor Documentation

mirror()

template<typename desc_t = dx::virtuel::stream::desc, typename preference_t = cf::preference, template< typename ... > typename stream_t = dx::stream::stream, template< typename ... > typename group_t = group, bool _hosted = false>

dx::coreaudio::device< desc_t, preference_t, stream_t, group_t, _hosted >::mirror::mirror ( device & device, dx::stream::setting setting )

inline

Member Function Documentation

commit()

void dx::promoted< uint32_t >::commit ( lock_t && lock, const value_t & value )

inlineinherited

the server's answer: the value stands, the transition ends and the listeners are told - outside the lock, so a listener may read the promoted back

operator bool()

dx::coreaudio::promoted::property< uint32_t, ::CFNumberRef, settable >::operator bool ( ) const

inlinenoexceptinherited

operator const value_t &()

dx::promoted< uint32_t >::operator const value_t & ( )

inlineinherited

operator++()

value_t dx::promoted< uint32_t >::operator++ ( int )

inlinenoexceptinherited

operator+=()

promoted & dx::promoted< uint32_t >::operator+= ( const value_t & value )

inlinenoexceptinherited

operator--()

value_t dx::promoted< uint32_t >::operator-- ( int )

inlinenoexceptinherited

operator-=()

promoted & dx::promoted< uint32_t >::operator-= ( const value_t & value )

inlinenoexceptinherited

operator->()

const value_t & dx::promoted< uint32_t >::operator-> ( )

inlineinherited

operator==()

bool dx::promoted< uint32_t >::operator== ( const value_t & value )

inlineinherited

Member Data Documentation

backing_store

store dx::coreaudio::promoted::property< uint32_t, ::CFNumberRef, settable >::backing_store

protectedinherited

initialized

bool dx::promoted< uint32_t >::initialized

inherited

listen

inherited

listener

listener<decltype(promoted::listen)> dx::coreaudio::promoted::property< uint32_t, ::CFNumberRef, settable >::listener

protectedinherited

selectors

template<typename desc_t = dx::virtuel::stream::desc, typename preference_t = cf::preference, template< typename ... > typename stream_t = dx::stream::stream, template< typename ... > typename group_t = group, bool _hosted = false>

::AudioObjectPropertySelector dx::coreaudio::device< desc_t, preference_t, stream_t, group_t, _hosted >::mirror::selectors[] = {coreaudio::property::pod::transport::sync_strategy, coreaudio::property::pod::transport::safety_offset_out, coreaudio::property::pod::transport::safety_offset_in}

static

server

std::function<void(lock_t&&, const value_t&, const value_t&)> dx::promoted< uint32_t >::server

inherited

\ indicate the value is in transition - does not have the new value yet

server: handle synchronous and asynchronous value updates and initialization lock: lock promoted value from access during update value: new value (if in transition) current: current value to allow discarding update and reverting to current value if update is not permitted

it needs to handle these case: not initialized and not in transition: initialze and commit the value not initialized and in transition: if dependent on external settings initialize a temporary and compare it with the new value and update the external setting if required make sure to commit the new value so listeners get notified either synchronously or asynchronously by external notification initialized and in transition: update external settings if any and make sure to commit the new value so listeners get notified either synchronously or asynchronousl by external notification

server will not be called with this state: initialized and not in transation

for synchronous operation: move lock to commit for asynchronous operation: store lock and at asynchronous response restore and move lock to commit

transient

bool dx::promoted< uint32_t >::transient

inherited

\ indicate the value has been initialized

value

value_t dx::promoted< uint32_t >::value

protectedinherited

---

The documentation for this struct was generated from the following file:

• dx_coreaudio_device.h