dxd - dynax driver framework 3.0.0d222
cross platform open source driver development framework
Loading...
Searching...
No Matches
dx::proxy::stream::device< desc_t, preference_t, stream_t, group_t > Class Template Referenceabstract

< the app's consumer group (dx::stream::engine::group) wraps this bus's own More...

#include <dx_proxy_stream_device.h>

Inheritance diagram for dx::proxy::stream::device< desc_t, preference_t, stream_t, group_t >:
Collaboration diagram for dx::proxy::stream::device< desc_t, preference_t, stream_t, group_t >:

Public Types

typedef dx::stream::desc<> desc_t
typedef shared::event event_t
 the driver signals this client through it: the engine's clock and every stream's data events
typedef promoted< uint32_t >::template preference< decltype(dx::proxy::device< dx::preference >::preference)> source_t
typedef stream< device< dx::stream::desc<>, dx::preference, stream, group > > stream_t
typedef desc value_t

Public Member Functions

struct streamalign (struct stream *sync_reference)
uint32_t align (uint32_t sync_reference) const
void attach (channel_t **io[dx::stream::direction::directions][2], const std::vector< bool >(&channel_map)[2])
DX_PRAGMA_IGNORE_RETURN_VALUE_BEGIN catch (const dx::exception &__dx_exception)
void conclude () noexcept override
 conclude notifacation: device will be removed from tree
unsigned char configuration (unsigned char configuration) try
DX_PRAGMA_IGNORE_RETURN_VALUE_END unsigned char configurations () const try
auto count () const noexcept
void ctl (uint32_t ioctl) const try
void ctl (unsigned int ioctl) const
 dx_catchall_handler (this,) protected
 operator[](): a group just came into existence, a host wires its per-group transports here
 dx_catchall_handler_or_rethrow (this, exception.error==not_implemented, return 0;) void hw_clock(override
 registers this client's buffer switch event with the driver's clock domain
 dx_catchall_rethrow () template< typename rx_t > enable_if_ptr< rx_t > ictl(uint32_t ioctl) const try
 dx_catchall_rethrow () template< typename rx_t > enable_if_scalar< rx_t > ictl(uint32_t ioctl) const try
 dx_catchall_rethrow () template< typename rx_t > hide_if_scalar_or_ptr< rx_t > ictl(uint32_t ioctl) const try
 member ioctl
 dx_catchall_rethrow () template< typename rx_t > size_t ictl(uint32_t ioctl
 dx_catchall_rethrow () template< typename tx_t
 dx_catchall_rethrow () ~device() override
 the device class destructor
 dx_catchall_rethrow (, "name: %s, access rights: %x, sharing options:%x", name, access, share)
 dx_pass (::IOConnectCallStructMethod(io_connect, ioctl, nullptr, 0, &rx, &size), "%s rx:%p size:%d", fourchar::to::string(ioctl).c_str(), &rx, size)
uint32_t enumerate (const format &format=any) const
 enumerate typified pins
void exception (const dx::exception &exception, bool filtered=false) const noexcept override
 notification exception handler
struct streamfind (const decltype(stream::target.idx())&target)
struct streamfind (const format &format=any, enum direction::direction direction=direction::any)
struct streamfind (const target_t &target)
struct streamfind (uint32_t &pin, const format &format=any, enum direction::direction direction=direction::any)
 finds and returns the stream description and pin idx into this stream
DX_PRAGMA_IGNORE_RETURN_VALUE_BEGIN virtual DX_PRAGMA_IGNORE_RETURN_VALUE_END uint64_t frame () const try
value_t get (::CFStringRef key) const
::CFTypeRef get (::CFStringRef key) const
value_t get (::CFStringRef key, ::CFTypeRef dflt) const noexcept
::CFTypeRef get (::CFStringRef key, ::CFTypeRef dflt) const noexcept
value_t get (::CFStringRef key, value_t dflt) const noexcept
value_t get (key_t key) const
::CFTypeRef get (key_t key) const
void grouped (typename super::group< device< dx::stream::desc<>, dx::preference, stream, group > > &group) override
virtual bool hw_clock () const noexcept
virtual void hw_clock (abstract::event *hw_clock, uint32_t iosize)
rx_t ictl (unsigned int ioctl) const
 Windows: member ioctl.
size_t ictl (unsigned int ioctl, rx_t &rx) const
void info (std::ostream &os) noexcept override
 log object class information
void initialize (const char *name, ::DWORD access=GENERIC_READ|GENERIC_WRITE, ::DWORD share=FILE_SHARE_READ|FILE_SHARE_WRITE) try
 (re-)initialization the underlaying windows API is CreateFile(). for detailed information see http://msdn.microsoft.com/en-us/library/aa363858(VS.85).aspx
rx_t ioctl (unsigned int ioctl, const tx_t &tx) const
size_t ioctl (unsigned int ioctl, const tx_t &tx, rx_t &rx) const
void launch () override
 launch notification: object mounted and ready to use. Called only through try_launch() - never call this directly from outside the class hierarchy.
void octl (unsigned int ioctl, const tx_t &tx) const
 operator const ::io_registry_entry_t & () const noexcept
 auto converter into const io_object
 operator const ::io_registry_entry_t & () const noexcept
 auto converter into const io_object
 operator const os_event () const noexcept
 operator const std::string & () const noexcept
 identifying device string, mirroring macOS' io::registry conversion
 operator os_event () noexcept
 operator uint64_t () const
 operator::CFMutableDictionaryRef () const
 operator::CFStringRef () const
 operator::HANDLE () const noexcept
 operator::io_registry_entry_t & () noexcept
 auto converter into io_object
 operator::io_registry_entry_t & () noexcept
 auto converter into io_object
 operator::io_registry_entry_t * () noexcept
 auto converter into io_object pointer
 operator::io_registry_entry_t * () noexcept
 auto converter into io_object pointer
bool operator== (::io_registry_entry_t io_object) const noexcept
bool operator== (const desc &desc) const
virtual deviceoperator>> (std::ostream &) const
virtual deviceoperator>> (std::ostream &) const
::CFTypeRef operator[] (::CFStringRef key) const
group< device< dx::stream::desc<>, dx::preference, stream, group > > & operator[] (const typename dx::stream::desc<>::stream::desc &stream)
 the stream's group, created on first use
::CFTypeRef operator[] (key_t key) const
group_toperator[] (const typename dx::stream::desc<>::stream::desc &stream)
 the stream's group, created on first use
registry parent () const
_devicereset ()
referenceretain ()
deviceset (::CFStringRef key, ::CFTypeRef value) noexcept
deviceset (::CFStringRef key, value_t value)
deviceset (::CFTypeRef properties)
 Setting properties in a registry entry is not generally supported, it is more common to support setting of properties of the connection based property setting of dx::device.
deviceset (key_t key, ::CFTypeRef value)
deviceset (key_t key, value_t value)
virtual void sleep ()
 notify system will sleep stub
virtual void sleep ()
 notify system will sleep stub
virtual std::pair< source_t &, bool > source (const struct dx::stream::desc<>::stream &stream)
 the stream's source selector, created on first use: the preference by stream target, the value an index into the stream's sources
virtual DX_PRAGMA_IGNORE_RETURN_VALUE_END std::string string (uint8_t) const
uint32_t sync_reference (struct stream *sync_reference)
struct streamsync_reference (uint32_t sync_reference)
bool try_conclude () noexcept
 atomically conclude()s if currently launched; returns whether this call did it
bool try_conclude () noexcept
 atomically conclude()s if currently launched; returns whether this call did it
bool try_launch ()
 atomically launch()es if not already launched; returns whether this call did it
bool try_launch ()
 atomically launch()es if not already launched; returns whether this call did it
void wake () override

Static Public Member Functions

static void create (const char *product_id, const ::GUID &guid, const std::string &id, const desc_t &desc)
 persisted software device: PnP keeps it enumerated after the creating handle closes
static void create (const char *product_id, const ::GUID &guid, const std::string &id, const dx::stream::desc<> &desc)
 persisted software device: PnP keeps it enumerated after the creating handle closes
static void destroy (const char *product_id, const ::GUID &guid, const std::string &id)
 re-acquires the persisted device and binds it to the closing handle; PnP keeps the removed device's node as a phantom, uninstalled here

Public Attributes

cf::string bundle_id
dx::stream::bus::bus bus {}
 the bus this device hangs on
promoted< typename super::client_map, typename super::client_map::value_t > clients
dx::shared::guard< std::map< abstract::event *, dx::stream::clock::consumer > > clock
 event -> its own iosize and sample counter
uint32_t clocks {}
 number of independent clocks [currenlty only single clock support]
promoted< uint32_t >::preference< decltype(dx::proxy::device< dx::preference >::preference)> clocksource
promoted< dx::stream::desc<>, typename dx::stream::desc<>::value_tdesc
bool dflt {}
 can be selected as default (OS audio) device
dx::driver< decltype(id), dx::preference > & driver
dx::driver< decltype(id), dx::preference > & driver
bool editable {}
 can be edited
struct dx::stream::desc::firmware firmware
std::map< decltype(dx::stream::desc<>::stream::group), group< device< dx::stream::desc<>, dx::preference, stream, group > > > group
bool hidden {}
 hide device
struct { 
   dx::shared::guard< std::map< abstract::event *, dx::stream::clock::consumer > >   clock 
 event -> its own iosize and sample counter More...
   uint32_t   iosize 
 staging value for registration paths without their own iosize argument (macOS CF property bridge) More...
hw
promoted< std::string > icon
const ::io_service_t id
const std::string id
promoted< uint32_t >::preference< decltype(dx::proxy::device< dx::preference >::preference)> iosize
uint32_t iosize
 staging value for registration paths without their own iosize argument (macOS CF property bridge)
chain< uint32_tiosize_server
std::atomic< bool > launched
std::atomic< bool > launched
struct dx::stream::desc::name_id model
dx::stream::device::monitor monitor
bool persistence {}
 device has capability to store persistent settings (i.e. sample rate; clock source; etc.)
dx::preference preference
dx::preference preference
std::string puid
 persistent UID - system unique - could change with location
std::string puid
 persistent UID - system unique - could change with location
std::string puuid
 persistent universal UID - universally unique ID (i.e. serial number)
std::string puuid
 persistent universal UID - universally unique ID (i.e. serial number)
std::list< promoted< uint32_t > > safety_offset_server
 per group: the kernel keeps the client margins of its streams
dx::promoted< uint32_tsamplerate
return size
std::map< decltype(dx::stream::desc<>::stream::target.idx()), source_tsources
direction::direction start_stop_order = direction::any
struct dx::stream::desc::stream stream [max_streams]
uint32_t streams {}
 number of streams
promoted< structdesc_t::stream * >::template preference< decltype(dx::proxy::device< dx::preference >::preference), uint32_tsync_reference
DX_PRAGMA_IGNORE_RETURN_VALUE_END class dx::proxy::stream::_device::monitorthis
rx_t &rx const try
struct dx::stream::desc::name_id vendor
dx::stream::device::monitor version

Static Public Attributes

static constexpr bool hosted
 the transport's settings belong to another process' device: a hosted device mirrors them through its chains, it keeps no store of them

Protected Types

typedef service::request< service::stream::data< typename super_device_t::dx::stream::desc<> > > request
typedef pipe< request >::template server< user_client, std::weak_ptr< device > > server
 pipe::server connecting user_clients The pipe holds a std::weak_ptr<device> as a temporary by the pipe::server::args variadic tuple to create shared device references for the user_client. At time of device construction there is not yet a std::shared_ptr<device>, therefore the pipe::server::args weak_ptr assignment happens at service::device::launch().
enum  type

Protected Member Functions

std::string canonical (const std::string &name) const try
 catch (...)
 dx_catchall_rethrow () registry(const registry &registry
registryerase (const char *subkey=nullptr) noexcept
void grouped (typename super::group< device< dx::stream::desc<>, dx::preference, stream, group > > &group) override
registryinitialize (const std::string &key, ::HKEY root=HKEY_CURRENT_USER, ::REGSAM rights=KEY_ALL_ACCESS) try
registryinitialize (const std::string &key, ::REGSAM rights, ::HKEY root, const char *path=nullptr) try
virtual void launch ()
 launch notification: object mounted and ready to use. Called only through try_launch() - never call this directly from outside the class hierarchy.
registryrun ()
dx_catchall_rethrow() registry &initialize(size_t size () const noexcept

Static Protected Member Functions

static self_t void assign (const self_t &self, const value_t &value) try
static self_t void assign (const self_t &self, const value_t &value) try
static registry at (const self_t &self)
static container_t children (const self_t &self) noexcept try
static bool fetch (const self_t &self, value_t &value) try
static bool fetch (const self_t &self, value_t &value) try
static bool nested (const self_t &self) noexcept
static size_t size (const self_t &self) noexcept

Protected Attributes

bool connected
std::list< promoted > group_server
 per-group chains, wired as each group comes into existence (grouped())
::HANDLE handle
struct { 
   cf::string   bundle_id 
   cf::string   class_name 
kernel
std::string key
const std::string & key
std::deque< std::function< void()> > listen
const std::string owns_root
class dx::service::device::promoted pipe
server pipe
io::port port
::HANDLE process
const std::string root
bool schedule_erase

Detailed Description

template<typename desc_t = dx::stream::desc<>, typename preference_t = dx::preference, template< typename ... > typename stream_t = stream, template< typename ... > typename group_t = group>
class dx::proxy::stream::device< desc_t, preference_t, stream_t, group_t >

< the app's consumer group (dx::stream::engine::group) wraps this bus's own

Member Typedef Documentation

◆ desc_t

◆ event_t

the driver signals this client through it: the engine's clock and every stream's data events

◆ request

typedef service::request<service::stream::data<typename super_device_t::dx::stream::desc<>> > dx::service::device< dx::preference >::request
protectedinherited

◆ server

typedef pipe<request>::template server<user_client, std::weak_ptr<device> > dx::service::device< dx::preference >::server
protectedinherited

pipe::server connecting user_clients The pipe holds a std::weak_ptr<device> as a temporary by the pipe::server::args variadic tuple to create shared device references for the user_client. At time of device construction there is not yet a std::shared_ptr<device>, therefore the pipe::server::args weak_ptr assignment happens at service::device::launch().

◆ source_t

◆ stream_t

◆ value_t

template<typename target_t = void_struct, int max_streams = 2, int max_pins = 1, int max_clock_settings = 1, int max_clocks = 1, int max_configurations = 1, int max_sources = 1>
typedef desc dx::stream::desc< target_t, max_streams, max_pins, max_clock_settings, max_clocks, max_configurations, max_sources >::value_t
inherited

Member Enumeration Documentation

◆ type

enum dx::registry::type : ::DWORD
strongprotectedinherited

Member Function Documentation

◆ align() [1/2]

template<typename target_t = void_struct, int max_streams = 2, int max_pins = 1, int max_clock_settings = 1, int max_clocks = 1, int max_configurations = 1, int max_sources = 1>
struct stream * dx::stream::desc< target_t, max_streams, max_pins, max_clock_settings, max_clocks, max_configurations, max_sources >::align ( struct stream * sync_reference)
inlineinherited

◆ align() [2/2]

template<typename target_t = void_struct, int max_streams = 2, int max_pins = 1, int max_clock_settings = 1, int max_clocks = 1, int max_configurations = 1, int max_sources = 1>
uint32_t dx::stream::desc< target_t, max_streams, max_pins, max_clock_settings, max_clocks, max_configurations, max_sources >::align ( uint32_t sync_reference) const
inlineinherited

◆ assign() [1/2]

self_t void dx::registry::assign ( const self_t & self,
const value_t & value )
inlinestaticprotectedinherited

◆ assign() [2/2]

self_t void dx::registry::assign ( const self_t & self,
const value_t & value )
inlinestaticprotectedinherited

◆ at()

registry dx::registry::at ( const self_t & self)
inlinestaticprotectedinherited

dx::key_value_tree<registry> contract: resolves self's parent chain into one real key/value position, then delegates below - the only place a registry[k1][k2]..[kN] chain becomes real subkeys/values.

◆ attach()

void dx::stream::device< dx::proxy::device< dx::preference >, dx::stream::desc<>, stream< device< dx::stream::desc<>, dx::preference, stream, group > >, group< device< dx::stream::desc<>, dx::preference, stream, group > > >::attach ( channel_t ** io[dx::stream::direction::directions][2],
const std::vector< bool >(&) channel_map[2] )
inlineinherited

◆ canonical()

std::string dx::registry::canonical ( const std::string & name) const
inlineprotectedinherited

◆ catch() [1/2]

dx::registry::catch ( ...)
inlineprotectedinherited

◆ catch() [2/2]

DX_PRAGMA_IGNORE_RETURN_VALUE_BEGIN dx::proxy::stream::_device< dx::stream::desc<>, dx::preference, stream< device< dx::stream::desc<>, dx::preference, stream, group > >, group< device< dx::stream::desc<>, dx::preference, stream, group > > >::catch ( const dx::exception & __dx_exception)
inlineinherited

◆ children()

container_t dx::registry::children ( const self_t & self)
inlinestaticprotectednoexceptinherited

self's own child names as any string container, yielding an empty one when the key is absent or inaccessible. Stays a static, not a dx::key_value_tree-style operator container_t(): registry is a dependent base of key_value_tree<registry> (inherited via the tree_t template parameter), and key_value_tree's own operator value_t() becomes entirely unreachable once a dependent base declares a same-shaped operator container_t() template of its own.

◆ conclude()

conclude notifacation: device will be removed from tree

Reimplemented from dx::proxy::device< dx::preference >.

◆ configuration()

unsigned char dx::proxy::stream::_device< dx::stream::desc<>, dx::preference, stream< device< dx::stream::desc<>, dx::preference, stream, group > >, group< device< dx::stream::desc<>, dx::preference, stream, group > > >::configuration ( unsigned char configuration)
inlineinherited

◆ configurations()

DX_PRAGMA_IGNORE_RETURN_VALUE_END unsigned char dx::proxy::stream::_device< dx::stream::desc<>, dx::preference, stream< device< dx::stream::desc<>, dx::preference, stream, group > >, group< device< dx::stream::desc<>, dx::preference, stream, group > > >::configurations ( ) const
inlineinherited

◆ count()

auto io::reference< ::io_registry_entry_t >::count ( ) const
inlinenoexceptinherited

◆ create() [1/2]

void dx::proxy::device< dx::preference >::create ( const char * product_id,
const ::GUID & guid,
const std::string & id,
const desc_t & desc )
inlinestaticinherited

persisted software device: PnP keeps it enumerated after the creating handle closes

◆ create() [2/2]

void dx::proxy::device< dx::preference >::create ( const char * product_id,
const ::GUID & guid,
const std::string & id,
const dx::stream::desc<> & desc )
inlinestaticinherited

persisted software device: PnP keeps it enumerated after the creating handle closes

◆ ctl() [1/2]

void dx::proxy::device< dx::preference >::ctl ( uint32_t ioctl) const
inlineinherited

◆ ctl() [2/2]

void dx::proxy::device< dx::preference >::ctl ( unsigned int ioctl) const
inlineinherited

◆ destroy()

void dx::proxy::device< dx::preference >::destroy ( const char * product_id,
const ::GUID & guid,
const std::string & id )
inlinestaticinherited

re-acquires the persisted device and binds it to the closing handle; PnP keeps the removed device's node as a phantom, uninstalled here

◆ dx_catchall_handler()

operator[](): a group just came into existence, a host wires its per-group transports here

◆ dx_catchall_handler_or_rethrow()

dx::proxy::stream::_device< dx::stream::desc<>, dx::preference, stream< device< dx::stream::desc<>, dx::preference, stream, group > >, group< device< dx::stream::desc<>, dx::preference, stream, group > > >::dx_catchall_handler_or_rethrow ( this ,
exception. error = not_implemented,
return 0;  )
inlinepure virtualinherited

registers this client's buffer switch event with the driver's clock domain

The driver owns the clock: it signals every registered client at that client's own iosize, so the engine's event has to be one the driver can signal. A device whose driver does not take the registration falls back to the engine's own software clock through not_implemented.

◆ dx_catchall_rethrow() [1/8]

dx::registry::dx_catchall_rethrow ( ) const &
protectedinherited

cheap: purely in-memory identity extension with a bare child name - what dx::key_value_tree::operator[] builds on.

◆ dx_catchall_rethrow() [2/8]

dx::proxy::device< dx::preference >::dx_catchall_rethrow ( ) const
inlineinherited

◆ dx_catchall_rethrow() [3/8]

dx::proxy::device< dx::preference >::dx_catchall_rethrow ( ) const
inlineinherited

◆ dx_catchall_rethrow() [4/8]

dx::proxy::device< dx::preference >::dx_catchall_rethrow ( ) const
inlineinherited

member ioctl

this member retreives data from the device by providing an IOCTL code. the template argument defines the type of data to be retreived. this member is intended as a convinient way to retreive only small amounts of data since there is an intermediate stack copy involved in returning the data.

◆ dx_catchall_rethrow() [5/8]

dx::proxy::device< dx::preference >::dx_catchall_rethrow ( )
inherited

◆ dx_catchall_rethrow() [6/8]

dx::proxy::device< dx::preference >::dx_catchall_rethrow ( )
inherited

◆ dx_catchall_rethrow() [7/8]

dx::proxy::device< dx::preference >::dx_catchall_rethrow ( )
inlineoverrideinherited

the device class destructor

the underlaying IOKit API is IOServiceClose().

remark: The io_service reference itself is managed by inherited io::reference

for detailed information see

Disconnect notification port,

closes the connection to the IOService object

◆ dx_catchall_rethrow() [8/8]

dx::file::dx_catchall_rethrow ( "name: % s,
access rights:% x,
sharing options:%x" ,
name ,
access ,
share  )
inherited

◆ dx_pass()

dx::proxy::device< dx::preference >::dx_pass ( ::IOConnectCallStructMethod( io_connect, ioctl, nullptr, 0, &rx, &size) ,
"%s rx:%p size:%d" ,
fourchar::to::string(ioctl).c_str() ,
& rx,
size  )
inherited

◆ enumerate()

template<typename target_t = void_struct, int max_streams = 2, int max_pins = 1, int max_clock_settings = 1, int max_clocks = 1, int max_configurations = 1, int max_sources = 1>
uint32_t dx::stream::desc< target_t, max_streams, max_pins, max_clock_settings, max_clocks, max_configurations, max_sources >::enumerate ( const format & format = any) const
inlineinherited

enumerate typified pins

Here is the caller graph for this function:

◆ erase()

registry & dx::registry::erase ( const char * subkey = nullptr)
inlineprotectednoexceptinherited

◆ exception()

void dx::proxy::device< dx::preference >::exception ( const dx::exception & exception,
bool filtered = false ) const
inlineoverridenoexceptinherited

notification exception handler

◆ fetch() [1/2]

bool dx::registry::fetch ( const self_t & self,
value_t & value )
inlinestaticprotectedinherited

a value that serializes itself into a tree node recurses through its own named children; only what has no such serialization reaches the flat position below, where a struct would become one opaque REG_BINARY of its layout

◆ fetch() [2/2]

bool dx::registry::fetch ( const self_t & self,
value_t & value )
inlinestaticprotectedinherited

a value that serializes itself into a tree node recurses through its own named children; only what has no such serialization reaches the flat position below, where a struct would become one opaque REG_BINARY of its layout

◆ find() [1/4]

template<typename target_t = void_struct, int max_streams = 2, int max_pins = 1, int max_clock_settings = 1, int max_clocks = 1, int max_configurations = 1, int max_sources = 1>
struct stream * dx::stream::desc< target_t, max_streams, max_pins, max_clock_settings, max_clocks, max_configurations, max_sources >::find ( const decltype(stream::target.idx())& target)
inlineinherited

◆ find() [2/4]

template<typename target_t = void_struct, int max_streams = 2, int max_pins = 1, int max_clock_settings = 1, int max_clocks = 1, int max_configurations = 1, int max_sources = 1>
struct stream * dx::stream::desc< target_t, max_streams, max_pins, max_clock_settings, max_clocks, max_configurations, max_sources >::find ( const format & format = any,
enum direction::direction direction = direction::any )
inlineinherited
Parameters
formatsearch stream format filter
directionsearch stream direction filter

◆ find() [3/4]

template<typename target_t = void_struct, int max_streams = 2, int max_pins = 1, int max_clock_settings = 1, int max_clocks = 1, int max_configurations = 1, int max_sources = 1>
struct stream * dx::stream::desc< target_t, max_streams, max_pins, max_clock_settings, max_clocks, max_configurations, max_sources >::find ( const target_t & target)
inlineinherited

◆ find() [4/4]

template<typename target_t = void_struct, int max_streams = 2, int max_pins = 1, int max_clock_settings = 1, int max_clocks = 1, int max_configurations = 1, int max_sources = 1>
struct stream * dx::stream::desc< target_t, max_streams, max_pins, max_clock_settings, max_clocks, max_configurations, max_sources >::find ( uint32_t & pin,
const format & format = any,
enum direction::direction direction = direction::any )
inlineinherited

finds and returns the stream description and pin idx into this stream

Returns
stream description of indexed pin, pin idx will be altered on return!
Parameters
pinin: global pin index, out: pin index into returned stream description
formatsearch stream format filter
directionsearch stream direction filter
Here is the caller graph for this function:

◆ frame()

DX_PRAGMA_IGNORE_RETURN_VALUE_BEGIN virtual DX_PRAGMA_IGNORE_RETURN_VALUE_END uint64_t dx::proxy::stream::_device< dx::stream::desc<>, dx::preference, stream< device< dx::stream::desc<>, dx::preference, stream, group > >, group< device< dx::stream::desc<>, dx::preference, stream, group > > >::frame ( ) const
inlinevirtualinherited

◆ get() [1/7]

value_t io::registry::get ( ::CFStringRef key) const
inlineinherited

◆ get() [2/7]

::CFTypeRef io::registry::get ( ::CFStringRef key) const
inlineinherited

◆ get() [3/7]

value_t io::registry::get ( ::CFStringRef key,
::CFTypeRef dflt ) const
inlinenoexceptinherited

◆ get() [4/7]

::CFTypeRef io::registry::get ( ::CFStringRef key,
::CFTypeRef dflt ) const
inlinenoexceptinherited

◆ get() [5/7]

value_t io::registry::get ( ::CFStringRef key,
value_t dflt ) const
inlinenoexceptinherited

◆ get() [6/7]

value_t io::registry::get ( key_t key) const
inlineinherited

◆ get() [7/7]

::CFTypeRef io::registry::get ( key_t key) const
inlineinherited

◆ grouped() [1/2]

◆ grouped() [2/2]

void dx::service::device< dx::preference >::grouped ( typename super::group< device< dx::stream::desc<>, dx::preference, stream, group > > & group)
inlineoverrideprotectedinherited

◆ hw_clock() [1/2]

virtual bool dx::stream::device< dx::proxy::device< dx::preference >, dx::stream::desc<>, stream< device< dx::stream::desc<>, dx::preference, stream, group > >, group< device< dx::stream::desc<>, dx::preference, stream, group > > >::hw_clock ( ) const
inlinevirtualnoexceptinherited

◆ hw_clock() [2/2]

◆ ictl() [1/2]

rx_t dx::proxy::device< dx::preference >::ictl ( unsigned int ioctl) const
inlineinherited

Windows: member ioctl.

this member retreives data from the device by providing an IOCTL code. the template argument defines the type of data to be retreived. this member is intended as a convinient way to retreive only small amounts of data since there is an intermediate stack copy involved in returning the data.

the underlaying windows API is DeviceIoControl(). for detailed information see http://msdn.microsoft.com/en-us/library/aa363216(VS.85).aspx

Exceptions
n/amicrosoft does not give information about what possible errors values are provided by its OS other than
ERROR_INSUFFICIENT_BUFFERif the output buffer is too small to receive any data
Template Parameters
rx_ttype of rx_t needs to be explicitly specified as it can't be deduced

◆ ictl() [2/2]

size_t dx::proxy::device< dx::preference >::ictl ( unsigned int ioctl,
rx_t & rx ) const
inlineinherited

◆ info()

void dx::proxy::stream::_device< dx::stream::desc<>, dx::preference, stream< device< dx::stream::desc<>, dx::preference, stream, group > >, group< device< dx::stream::desc<>, dx::preference, stream, group > > >::info ( std::ostream & os)
inlineoverridevirtualnoexceptinherited

log object class information

Reimplemented from dx::proxy::device< dx::preference >.

◆ initialize() [1/3]

void dx::file::initialize ( const char * name,
::DWORD access = GENERIC_READ| GENERIC_WRITE,
::DWORD share = FILE_SHARE_READ| FILE_SHARE_WRITE )
inlineinherited

(re-)initialization the underlaying windows API is CreateFile(). for detailed information see http://msdn.microsoft.com/en-us/library/aa363858(VS.85).aspx

Exceptions
n/amicrosoft does not give information about what possible errors values are provided by its OS

◆ initialize() [2/3]

registry & dx::registry::initialize ( const std::string & key,
::HKEY root = HKEY_CURRENT_USER,
::REGSAM rights = KEY_ALL_ACCESS )
inlineprotectedinherited

◆ initialize() [3/3]

registry & dx::registry::initialize ( const std::string & key,
::REGSAM rights,
::HKEY root,
const char * path = nullptr )
inlineprotectedinherited

◆ ioctl() [1/2]

rx_t dx::proxy::device< dx::preference >::ioctl ( unsigned int ioctl,
const tx_t & tx ) const
inlineinherited

◆ ioctl() [2/2]

size_t dx::proxy::device< dx::preference >::ioctl ( unsigned int ioctl,
const tx_t & tx,
rx_t & rx ) const
inlineinherited

◆ launch() [1/2]

virtual void dx::object::launch ( )
inlineprotectedvirtualinherited

launch notification: object mounted and ready to use. Called only through try_launch() - never call this directly from outside the class hierarchy.

◆ launch() [2/2]

void dx::service::device< dx::preference >::launch ( )
inlineoverrideinherited

launch notification: object mounted and ready to use. Called only through try_launch() - never call this directly from outside the class hierarchy.

◆ nested()

bool dx::registry::nested ( const self_t & self)
inlinestaticprotectednoexceptinherited

◆ octl()

void dx::proxy::device< dx::preference >::octl ( unsigned int ioctl,
const tx_t & tx ) const
inlineinherited

◆ operator const ::io_registry_entry_t &() [1/2]

io::reference< ::io_registry_entry_t >::operator const ::io_registry_entry_t & ( ) const
inlinenoexceptinherited

auto converter into const io_object

◆ operator const ::io_registry_entry_t &() [2/2]

io::reference< ::io_registry_entry_t >::operator const ::io_registry_entry_t & ( ) const
inlinenoexceptinherited

auto converter into const io_object

◆ operator const os_event()

dx::resource< invalid_t >::operator const os_event ( ) const
inlinenoexceptinherited

◆ operator const std::string &()

dx::proxy::device< dx::preference >::operator const std::string & ( ) const
inlinenoexceptinherited

identifying device string, mirroring macOS' io::registry conversion

◆ operator os_event()

dx::resource< invalid_t >::operator os_event ( )
inlinenoexceptinherited

◆ operator uint64_t()

io::registry::operator uint64_t ( ) const
inlineexplicitinherited

◆ operator::CFMutableDictionaryRef()

io::registry::operator::CFMutableDictionaryRef ( ) const
inlineexplicitinherited

◆ operator::CFStringRef()

io::registry::operator::CFStringRef ( ) const
inlineexplicitinherited

◆ operator::HANDLE()

dx::resource< invalid_t >::operator::HANDLE ( ) const
inlinenoexceptinherited

◆ operator::io_registry_entry_t &() [1/2]

io::reference< ::io_registry_entry_t >::operator ::io_registry_entry_t & ( )
inlinenoexceptinherited

auto converter into io_object

◆ operator::io_registry_entry_t &() [2/2]

io::reference< ::io_registry_entry_t >::operator ::io_registry_entry_t & ( )
inlinenoexceptinherited

auto converter into io_object

◆ operator::io_registry_entry_t *() [1/2]

io::reference< ::io_registry_entry_t >::operator ::io_registry_entry_t * ( )
inlinenoexceptinherited

auto converter into io_object pointer

◆ operator::io_registry_entry_t *() [2/2]

io::reference< ::io_registry_entry_t >::operator ::io_registry_entry_t * ( )
inlinenoexceptinherited

auto converter into io_object pointer

◆ operator==() [1/2]

bool io::reference< ::io_registry_entry_t >::operator== ( ::io_registry_entry_t io_object) const
inlinenoexceptinherited

◆ operator==() [2/2]

template<typename target_t = void_struct, int max_streams = 2, int max_pins = 1, int max_clock_settings = 1, int max_clocks = 1, int max_configurations = 1, int max_sources = 1>
bool dx::stream::desc< target_t, max_streams, max_pins, max_clock_settings, max_clocks, max_configurations, max_sources >::operator== ( const desc< target_t, max_streams, max_pins, max_clock_settings, max_clocks, max_configurations, max_sources > & desc) const
inlineinherited

◆ operator>>() [1/2]

virtual device & dx::device< ::io_service_t, dx::preference >::operator>> ( std::ostream & ) const
inlinevirtualinherited

◆ operator>>() [2/2]

virtual device & dx::device< std::string, dx::preference >::operator>> ( std::ostream & ) const
inlinevirtualinherited

◆ operator[]() [1/4]

::CFTypeRef io::registry::operator[] ( ::CFStringRef key) const
inlineinherited

◆ operator[]() [2/4]

the stream's group, created on first use

◆ operator[]() [3/4]

::CFTypeRef io::registry::operator[] ( key_t key) const
inlineinherited

◆ operator[]() [4/4]

the stream's group, created on first use

◆ parent()

registry io::registry::parent ( ) const
inlineinherited

◆ reset()

◆ retain()

reference & io::reference< ::io_registry_entry_t >::retain ( )
inlineinherited

◆ run()

registry & dx::registry::run ( )
inlineprotectedinherited

◆ set() [1/5]

device & dx::proxy::device< dx::preference >::set ( ::CFStringRef key,
::CFTypeRef value )
inlinenoexceptinherited

◆ set() [2/5]

device & dx::proxy::device< dx::preference >::set ( ::CFStringRef key,
value_t value )
inlineinherited

◆ set() [3/5]

device & dx::proxy::device< dx::preference >::set ( ::CFTypeRef properties)
inlineinherited

Setting properties in a registry entry is not generally supported, it is more common to support setting of properties of the connection based property setting of dx::device.

◆ set() [4/5]

device & dx::proxy::device< dx::preference >::set ( key_t key,
::CFTypeRef value )
inlineinherited

◆ set() [5/5]

device & dx::proxy::device< dx::preference >::set ( key_t key,
value_t value )
inlineinherited

◆ size() [1/2]

dx_catchall_rethrow() registry &initialize(size_t dx::registry::size ( ) const
inlineprotectednoexceptinherited

stays a named method: base and derived conversion function templates are simultaneous overload candidates, so an operator value_t() here would compete with dx::key_value_tree's own. like get<value_t>() but returns false for ERROR_FILE_NOT_FOUND, from either RegQueryValueExA or value_of() itself; any other failure throws. a sibling thread/process may delete the containing key between value_of()'s create and the set - retry recreates the whole chain in that case subkey+value count, 0 if the key doesn't exist (key_of()'s non-throwing overload - an ordinary, expected outcome here, not a genuine error).

◆ size() [2/2]

size_t dx::registry::size ( const self_t & self)
inlinestaticprotectednoexceptinherited

◆ sleep() [1/2]

virtual void dx::device< ::io_service_t, dx::preference >::sleep ( )
inlinevirtualinherited

notify system will sleep stub

◆ sleep() [2/2]

virtual void dx::device< std::string, dx::preference >::sleep ( )
inlinevirtualinherited

notify system will sleep stub

◆ source()

virtual std::pair< source_t &, bool > dx::stream::device< dx::proxy::device< dx::preference >, dx::stream::desc<>, stream< device< dx::stream::desc<>, dx::preference, stream, group > >, group< device< dx::stream::desc<>, dx::preference, stream, group > > >::source ( const struct dx::stream::desc<>::stream & stream)
inlinevirtualinherited

the stream's source selector, created on first use: the preference by stream target, the value an index into the stream's sources

◆ string()

virtual DX_PRAGMA_IGNORE_RETURN_VALUE_END std::string dx::proxy::stream::_device< dx::stream::desc<>, dx::preference, stream< device< dx::stream::desc<>, dx::preference, stream, group > >, group< device< dx::stream::desc<>, dx::preference, stream, group > > >::string ( uint8_t ) const
inlinevirtualinherited

◆ sync_reference() [1/2]

template<typename target_t = void_struct, int max_streams = 2, int max_pins = 1, int max_clock_settings = 1, int max_clocks = 1, int max_configurations = 1, int max_sources = 1>
uint32_t dx::stream::desc< target_t, max_streams, max_pins, max_clock_settings, max_clocks, max_configurations, max_sources >::sync_reference ( struct stream * sync_reference)
inlineinherited

◆ sync_reference() [2/2]

template<typename target_t = void_struct, int max_streams = 2, int max_pins = 1, int max_clock_settings = 1, int max_clocks = 1, int max_configurations = 1, int max_sources = 1>
struct stream * dx::stream::desc< target_t, max_streams, max_pins, max_clock_settings, max_clocks, max_configurations, max_sources >::sync_reference ( uint32_t sync_reference)
inlineinherited

◆ try_conclude() [1/2]

bool dx::object::try_conclude ( )
inlinenoexceptinherited

atomically conclude()s if currently launched; returns whether this call did it

◆ try_conclude() [2/2]

bool dx::object::try_conclude ( )
inlinenoexceptinherited

atomically conclude()s if currently launched; returns whether this call did it

◆ try_launch() [1/2]

bool dx::object::try_launch ( )
inlineinherited

atomically launch()es if not already launched; returns whether this call did it

◆ try_launch() [2/2]

bool dx::object::try_launch ( )
inlineinherited

atomically launch()es if not already launched; returns whether this call did it

◆ wake()

Member Data Documentation

◆ bundle_id

◆ bus

template<typename target_t = void_struct, int max_streams = 2, int max_pins = 1, int max_clock_settings = 1, int max_clocks = 1, int max_configurations = 1, int max_sources = 1>
dx::stream::bus::bus dx::stream::desc< target_t, max_streams, max_pins, max_clock_settings, max_clocks, max_configurations, max_sources >::bus {}
inherited

the bus this device hangs on

◆ clients

promoted<typename super::client_map, typename super::client_map::value_t> dx::proxy::stream::_device< dx::stream::desc<>, dx::preference, stream< device< dx::stream::desc<>, dx::preference, stream, group > >, group< device< dx::stream::desc<>, dx::preference, stream, group > > >::clients
inherited

◆ clock

◆ clocks

template<typename target_t = void_struct, int max_streams = 2, int max_pins = 1, int max_clock_settings = 1, int max_clocks = 1, int max_configurations = 1, int max_sources = 1>
uint32_t dx::stream::desc< target_t, max_streams, max_pins, max_clock_settings, max_clocks, max_configurations, max_sources >::clocks {}
inherited

number of independent clocks [currenlty only single clock support]

◆ clocksource

◆ connected

bool dx::proxy::device< dx::preference >::connected
protectedinherited

◆ desc

◆ dflt

template<typename target_t = void_struct, int max_streams = 2, int max_pins = 1, int max_clock_settings = 1, int max_clocks = 1, int max_configurations = 1, int max_sources = 1>
bool dx::stream::desc< target_t, max_streams, max_pins, max_clock_settings, max_clocks, max_configurations, max_sources >::dflt {}
inherited

can be selected as default (OS audio) device

◆ driver [1/2]

dx::driver<decltype(id), dx::preference>& dx::device< ::io_service_t, dx::preference >::driver
inherited

◆ driver [2/2]

dx::driver<decltype(id), dx::preference>& dx::device< std::string, dx::preference >::driver
inherited

◆ editable

template<typename target_t = void_struct, int max_streams = 2, int max_pins = 1, int max_clock_settings = 1, int max_clocks = 1, int max_configurations = 1, int max_sources = 1>
bool dx::stream::desc< target_t, max_streams, max_pins, max_clock_settings, max_clocks, max_configurations, max_sources >::editable {}
inherited

can be edited

◆ firmware

template<typename target_t = void_struct, int max_streams = 2, int max_pins = 1, int max_clock_settings = 1, int max_clocks = 1, int max_configurations = 1, int max_sources = 1>
struct dx::stream::desc::firmware dx::stream::desc< target_t, max_streams, max_pins, max_clock_settings, max_clocks, max_configurations, max_sources >::firmware
inherited

◆ group

streaming groups by desc::stream::group id: every stream of this device is registered with its group

◆ group_server

std::list<promoted> dx::service::device< dx::preference >::group_server
protectedinherited

per-group chains, wired as each group comes into existence (grouped())

◆ handle

::HANDLE dx::resource< invalid_t >::handle
protectedinherited

◆ hidden

template<typename target_t = void_struct, int max_streams = 2, int max_pins = 1, int max_clock_settings = 1, int max_clocks = 1, int max_configurations = 1, int max_sources = 1>
bool dx::stream::desc< target_t, max_streams, max_pins, max_clock_settings, max_clocks, max_configurations, max_sources >::hidden {}
inherited

hide device

◆ hosted

the transport's settings belong to another process' device: a hosted device mirrors them through its chains, it keeps no store of them

◆ [struct]

Todo
migrate hw clock generation/distribution into a dedicated clock class

◆ icon

◆ id [1/2]

const ::io_service_t dx::device< ::io_service_t, dx::preference >::id
inherited

◆ id [2/2]

const std::string dx::device< std::string, dx::preference >::id
inherited

◆ iosize [1/2]

◆ iosize [2/2]

staging value for registration paths without their own iosize argument (macOS CF property bridge)

◆ iosize_server

◆ [struct]

struct { ... } dx::service::device< dx::preference >::kernel

◆ key [1/2]

std::string dx::registry::key
protectedinherited

◆ key [2/2]

const std::string& dx::registry::key
protectedinherited

◆ launched [1/2]

std::atomic<bool> dx::object::launched
inherited

◆ launched [2/2]

std::atomic<bool> dx::object::launched
inherited

◆ listen

std::deque<std::function<void()> > dx::registry::listen
protectedinherited

◆ model

template<typename target_t = void_struct, int max_streams = 2, int max_pins = 1, int max_clock_settings = 1, int max_clocks = 1, int max_configurations = 1, int max_sources = 1>
struct dx::stream::desc::name_id dx::stream::desc< target_t, max_streams, max_pins, max_clock_settings, max_clocks, max_configurations, max_sources >::model
inherited

◆ monitor

◆ owns_root

const std::string dx::registry::owns_root
protectedinherited

◆ persistence

template<typename target_t = void_struct, int max_streams = 2, int max_pins = 1, int max_clock_settings = 1, int max_clocks = 1, int max_configurations = 1, int max_sources = 1>
bool dx::stream::desc< target_t, max_streams, max_pins, max_clock_settings, max_clocks, max_configurations, max_sources >::persistence {}
inherited

device has capability to store persistent settings (i.e. sample rate; clock source; etc.)

◆ pipe [1/2]

◆ pipe [2/2]

◆ port

io::port dx::proxy::device< dx::preference >::port
protectedinherited

◆ preference [1/2]

dx::preference dx::device< ::io_service_t, dx::preference >::preference
inherited

◆ preference [2/2]

dx::preference dx::device< std::string, dx::preference >::preference
inherited

◆ process

::HANDLE dx::resource< invalid_t >::process
protectedinherited

◆ puid [1/2]

std::string dx::device< ::io_service_t, dx::preference >::puid
inherited

persistent UID - system unique - could change with location

◆ puid [2/2]

std::string dx::device< std::string, dx::preference >::puid
inherited

persistent UID - system unique - could change with location

◆ puuid [1/2]

std::string dx::device< ::io_service_t, dx::preference >::puuid
inherited

persistent universal UID - universally unique ID (i.e. serial number)

◆ puuid [2/2]

std::string dx::device< std::string, dx::preference >::puuid
inherited

persistent universal UID - universally unique ID (i.e. serial number)

◆ root

const std::string dx::registry::root
protectedinherited

◆ safety_offset_server

per group: the kernel keeps the client margins of its streams

◆ samplerate

◆ schedule_erase

bool dx::registry::schedule_erase
protectedinherited

◆ size

return dx::proxy::device< dx::preference >::size
inherited

◆ sources

source selectors by stream target: a stream with sources gets its own on first use

◆ start_stop_order

template<typename target_t = void_struct, int max_streams = 2, int max_pins = 1, int max_clock_settings = 1, int max_clocks = 1, int max_configurations = 1, int max_sources = 1>
direction::direction dx::stream::desc< target_t, max_streams, max_pins, max_clock_settings, max_clocks, max_configurations, max_sources >::start_stop_order = direction::any
inherited

◆ stream

template<typename target_t = void_struct, int max_streams = 2, int max_pins = 1, int max_clock_settings = 1, int max_clocks = 1, int max_configurations = 1, int max_sources = 1>
struct dx::stream::desc::stream dx::stream::desc< target_t, max_streams, max_pins, max_clock_settings, max_clocks, max_configurations, max_sources >::stream[max_streams]
inherited

◆ streams

template<typename target_t = void_struct, int max_streams = 2, int max_pins = 1, int max_clock_settings = 1, int max_clocks = 1, int max_configurations = 1, int max_sources = 1>
uint32_t dx::stream::desc< target_t, max_streams, max_pins, max_clock_settings, max_clocks, max_configurations, max_sources >::streams {}
inherited

number of streams

◆ sync_reference

◆ this

◆ try

rx_t& rx const dx::proxy::device< dx::preference >::try
inherited

◆ vendor

template<typename target_t = void_struct, int max_streams = 2, int max_pins = 1, int max_clock_settings = 1, int max_clocks = 1, int max_configurations = 1, int max_sources = 1>
struct dx::stream::desc::name_id dx::stream::desc< target_t, max_streams, max_pins, max_clock_settings, max_clocks, max_configurations, max_sources >::vendor
inherited

◆ version


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

(c) copyright 2009 dynamic acoustics e.U. generated on

a closed source license may be obtained by requesting a written permission from dynamic acoustics e.U.
however - governmental use generally and military use especially is strictly prohibited though.