dxd::streaming::device< base_t, desc_t, clock_server_t >::ring Class Reference

the ring one stream streams through, sized by the opening client More...

#include <dxd_stream_device.h>

Inheritance diagram for dxd::streaming::device< base_t, desc_t, clock_server_t >::ring:

Collaboration diagram for dxd::streaming::device< base_t, desc_t, clock_server_t >::ring:

Public Member Functions
return_t	each (exec_t exec)
void	free ()
void	free ()
	kernel map free
os_result	initialize (::IOMemoryDescriptor *iokit_memory_descriptor)
	IOKit memory initializer.
os_result	initialize (::IOMemoryDescriptor *iokit_memory_descriptor, size_t offset, size_t size)
	IOKit memory initializer.
os_result	initialize (const void *data, size_t size)
	IOKit memory initializer from kernel virtual addresses.
os_result	initialize (const void *data, size_t size)
	IOKit memory initializer.
os_result	initialize (const::MDL *mdl)
os_result	initialize (const::MDL *mdl, size_t offset, size_t size)
os_result	initialize (size_t size, unsigned int limit=64, unsigned int alignment=0, bool contigous=false)
	IOKit buffer initializer.
os_result	initialize (void *data, size_t size)
	IOKit memory initializer from kernel virtual addresses.
os_result	initialize (void *data, size_t size)
	IOKit memory initializer.
os_result	initialize (::IOMemoryDescriptor *iokit_memory_descriptor, size_t offset=0)
	IOKit kernel map initializer.
	operator const dx::circular * () const
	operator const::IOMemoryDescriptor * () const
	IOKit IOMemoryDescriptor* implicit cast.
	operator const::IOMemoryDescriptor * () const
	IOKit IOMemoryDescriptor* implicit cast.
	operator const::IOMemoryMap * () const
	operator dx::circular * () const
	operator uint64_t () const
	IOKit physical address (only relevant for contigous memory).
	operator uint64_t () const
	IOKit physical address (only relevant for contigous memory).
const dx::circular *	operator-> () const
	operator to use mapping like pointer
	operator::IOMemoryDescriptor * ()
	operator::IOMemoryDescriptor * ()
	operator::IOMemoryMap * ()
	operator::MDL * () const
	operator::MDL * () const
doubly::linked::abstract::event *	pop (doubly::linked::abstract::event *item)
	remove participating event, acquirable up to DISPATCH_LEVEL
doubly::linked::abstract::event *	pop ()
	pop item from head
list &	print ()
doubly::linked::abstract::event *	push (doubly::linked::abstract::event *item)
	push participating event, acquirable up to DISPATCH_LEVEL
item_t *	push (item_t *item)
	push item to head
template<typename reference_t>
int	release (reference_t &reference)
void	retain ()
	ring (class device &device, unsigned int idx, size_t size)
os_result	signal ()
size_t	size () const
	IOKit memory size.
size_t	size () const
	IOKit memory size.
size_t	size () const
	kernel mapping size

Public Attributes
promoted< dx::stream::format, server >	format
atomic< int >	references {}
os_result	status
	IOKit memory status.
os_result	status
	IOKit memory status.
os_result	status
	status of mapping object
os_result	status =not_initialized

Protected Member Functions
void	__lock ()
void	__lock ()
bool	__trylock ()
void	__unlock ()
void	__unlock ()
	operator const::KSPIN_LOCK & () const
	operator const::KSPIN_LOCK * () const
	operator::KSPIN_LOCK & ()
	operator::KSPIN_LOCK * ()

Protected Attributes
dx::circular *	_vm
	kernel virtual address mapping
::IOMemoryMap *	iokit_memory_map

Detailed Description

template<typename base_t, typename desc_t, typename clock_server_t>
class dxd::streaming::device< base_t, desc_t, clock_server_t >::ring

the ring one stream streams through, sized by the opening client

Every pin of that stream is an endpoint on this one ring: two of them make the loopback the interconnection device is. Its start/stop are the ring's own: the clock domain is counted by started, which every participant - WaveRT stream or control client - raises itself. It carries the format its participants agreed on: hardware dictates where it exists, a streaming participant keeps what runs so nobody drops out, and once the domain stopped the wider container wins.

Constructor & Destructor Documentation

ring()

template<typename base_t, typename desc_t, typename clock_server_t>

dxd::streaming::device< base_t, desc_t, clock_server_t >::ring::ring ( class device & device, unsigned int idx, size_t size )

inline

Here is the call graph for this function:

Member Function Documentation

__lock() [1/2]

void dxd::spinlock::__lock ( )

inlineprotectedinherited

__lock() [2/2]

void dxd::spinlock::__lock ( )

inlineprotectedinherited

__trylock()

bool dxd::spinlock::__trylock ( )

inlineprotectedinherited

__unlock() [1/2]

void dxd::spinlock::__unlock ( )

inlineprotectedinherited

__unlock() [2/2]

void dxd::spinlock::__unlock ( )

inlineprotectedinherited

each()

return_t dxd::linked::list< doubly::linked::abstract::event >::each ( exec_t exec )

inlineinherited

Here is the caller graph for this function:

free() [1/2]

void dxd::buffer< scope_t, 64, 0, false >::free ( )

inlineinherited

free() [2/2]

void dxd::map< scope_t, dx::circular >::free ( )

inlineinherited

kernel map free

Checks if kernel mapping already exists and

does not call unmap(): IOMemoryMap instances will unmap themselves upon free, ie. when the last client with a reference calls release. unmap() forces the IOMemoryMap to destroy the mapping it represents, regardless of the number of clients. releases the map object.

Here is the caller graph for this function:

initialize() [1/10]

os_result dxd::memory< scope_t >::initialize ( ::IOMemoryDescriptor * iokit_memory_descriptor )

inlineinherited

IOKit memory initializer.

initialize() [2/10]

os_result dxd::memory< scope_t >::initialize ( ::IOMemoryDescriptor * iokit_memory_descriptor, size_t offset, size_t size )

inlineinherited

IOKit memory initializer.

initialize() [3/10]

os_result dxd::memory< dx::kernel >::initialize ( const void * data, size_t size )

inherited

IOKit memory initializer from kernel virtual addresses.

Allows re-initialization.

Creates OS memory descriptor from kernel space data,size and

wires it down and synchronizes it.

Parameters

data	virtual read only kernel base address of range to create memory descriptor from
size	size of range to create memory descriptor from

initialize() [4/10]

os_result dxd::memory< scope_t >::initialize ( const void * data, size_t size )

inherited

IOKit memory initializer.

Parameters

data	virtual base address of range to create memory descriptor from
size	size of range to create memory descriptor from

initialize() [5/10]

os_result dxd::memory< scope_t >::initialize ( const::MDL * mdl )

inlineinherited

in contrast to an IOKit MemoryDescriptor MDLs do not support reference counting. take care when creating a dxd::memory from a dxd::buffer: although the dxd::memory holds an MDL to the buffer the buffer itself is not retained after the dxd::buffer is released!

initialize() [6/10]

os_result dxd::memory< scope_t >::initialize ( const::MDL * mdl, size_t offset, size_t size )

inlineinherited

initialize() [7/10]

os_result dxd::buffer< scope_t, 64, 0, false >::initialize ( size_t size, unsigned int limit = limit_t, unsigned int alignment = alignment_t, bool contigous = contigous_t )

inlineinherited

IOKit buffer initializer.

Allows re-initialization.

Creates a buffer and associated memory descriptor.

Wires down the backing store memory.

Parameters

size	size to be alloced by buffer object
limit	limit physical memory address space
alignment	enforce physical memory alignment
contigous	enforce contiguos physical memory

initialize() [8/10]

os_result dxd::memory< dx::kernel >::initialize ( void * data, size_t size )

inherited

IOKit memory initializer from kernel virtual addresses.

Allows re-initialization.

Creates OS memory descriptor from kernel space data,size and

wires it down and synchronizes it.

Parameters

data	virtual kernel base address of range to create memory descriptor from
size	size of range to create memory descriptor from

initialize() [9/10]

os_result dxd::memory< scope_t >::initialize ( void * data, size_t size )

inherited

IOKit memory initializer.

Parameters

data	virtual base address of range to create memory descriptor from
size	size of range to create memory descriptor from

initialize() [10/10]

os_result dxd::map< scope_t, dx::circular >::initialize ( ::IOMemoryDescriptor * iokit_memory_descriptor, size_t offset = 0 )

inlineinherited

IOKit kernel map initializer.

map<kernel> maps an IOMemoryDescriptor (typically cast of a dxd::memory or buffer class) into the kernel address space.

https://developer.apple.com/library/content/qa/qa1197/_index.html

Allows re-initialization.

Checks buffer object,

maps the buffer into the kernel (will fail if offset is given)

and obtains a kernel virtual address (apply offset here instead).

Parameters

iokit_memory_descriptor	IOMemoryDescriptor to be mapped into the kernel address space
offset	offset into memory descriptor to create mapping

Here is the caller graph for this function:

operator const dx::circular *()

dxd::map< scope_t, dx::circular >::operator const dx::circular * ( ) const

inlineinherited

operator const::IOMemoryDescriptor *() [1/2]

dxd::memory< scope_t >::operator const::IOMemoryDescriptor * ( ) const

inlineinherited

IOKit IOMemoryDescriptor* implicit cast.

operator const::IOMemoryDescriptor *() [2/2]

dxd::memory< scope_t >::operator const::IOMemoryDescriptor * ( ) const

inlineinherited

IOKit IOMemoryDescriptor* implicit cast.

operator const::IOMemoryMap *()

dxd::map< scope_t, dx::circular >::operator const::IOMemoryMap * ( ) const

inlineinherited

operator const::KSPIN_LOCK &()

dxd::spinlock::operator const::KSPIN_LOCK & ( ) const

inlineinherited

operator const::KSPIN_LOCK *()

dxd::spinlock::operator const::KSPIN_LOCK * ( ) const

inlineinherited

operator dx::circular *()

dxd::map< scope_t, dx::circular >::operator dx::circular * ( ) const

inlineinherited

operator uint64_t() [1/2]

dxd::memory< scope_t >::operator uint64_t ( ) const

inlineinherited

IOKit physical address (only relevant for contigous memory).

operator uint64_t() [2/2]

dxd::memory< scope_t >::operator uint64_t ( ) const

inlineinherited

IOKit physical address (only relevant for contigous memory).

operator->()

const dx::circular * dxd::map< scope_t, dx::circular >::operator-> ( ) const

inlineinherited

operator to use mapping like pointer

operator::IOMemoryDescriptor *() [1/2]

dxd::memory< scope_t >::operator::IOMemoryDescriptor * ( )

inlineinherited

operator::IOMemoryDescriptor *() [2/2]

dxd::memory< scope_t >::operator::IOMemoryDescriptor * ( )

inlineinherited

operator::IOMemoryMap *()

dxd::map< scope_t, dx::circular >::operator::IOMemoryMap * ( )

inlineinherited

operator::KSPIN_LOCK &()

dxd::spinlock::operator::KSPIN_LOCK & ( )

inlineinherited

operator::KSPIN_LOCK *()

dxd::spinlock::operator::KSPIN_LOCK * ( )

inlineinherited

operator::MDL *() [1/2]

dxd::memory< scope_t >::operator::MDL * ( ) const

inlineinherited

operator::MDL *() [2/2]

dxd::memory< scope_t >::operator::MDL * ( ) const

inlineinherited

pop() [1/2]

doubly::linked::abstract::event * dxd::broadcast::pop ( doubly::linked::abstract::event * item )

inlineinherited

remove participating event, acquirable up to DISPATCH_LEVEL

Here is the call graph for this function:

pop() [2/2]

doubly::linked::abstract::event * dxd::linked::list< doubly::linked::abstract::event >::pop ( )

inlineinherited

pop item from head

print()

list & dxd::doubly::linked::list< doubly::linked::abstract::event >::print ( )

inlineinherited

Here is the call graph for this function:

push() [1/2]

doubly::linked::abstract::event * dxd::broadcast::push ( doubly::linked::abstract::event * item )

inlineinherited

push participating event, acquirable up to DISPATCH_LEVEL

Here is the call graph for this function:

push() [2/2]

template<typename item_t = link>

item_t * dxd::linked::list< item_t >::push ( item_t * item )

inlineinherited

push item to head

Here is the caller graph for this function:

release()

template<typename reference_t>

int dxd::referenced::release ( reference_t & reference )

inlineinherited

retain()

void dxd::referenced::retain ( )

inlineinherited

signal()

os_result dxd::broadcast::signal ( )

inlineinherited

Here is the call graph for this function:

size() [1/3]

size_t dxd::memory< scope_t >::size ( ) const

inlineinherited

IOKit memory size.

size() [2/3]

size_t dxd::memory< scope_t >::size ( ) const

inlineinherited

IOKit memory size.

size() [3/3]

size_t dxd::map< scope_t, dx::circular >::size ( ) const

inlineinherited

kernel mapping size

Here is the caller graph for this function:

Member Data Documentation

_vm

dx::circular* dxd::map< scope_t, dx::circular >::_vm

protectedinherited

kernel virtual address mapping

format

template<typename base_t, typename desc_t, typename clock_server_t>

promoted<dx::stream::format, server> dxd::streaming::device< base_t, desc_t, clock_server_t >::ring::format

iokit_memory_map

::IOMemoryMap* dxd::map< scope_t, dx::circular >::iokit_memory_map

protectedinherited

references

atomic<int> dxd::referenced::references {}

inherited

status [1/4]

os_result dxd::memory< scope_t >::status

inherited

IOKit memory status.

status of memory object

status [2/4]

os_result dxd::memory< scope_t >::status

inherited

IOKit memory status.

status of memory object

status [3/4]

os_result dxd::map< scope_t, dx::circular >::status

inherited

status of mapping object

status [4/4]

os_result dxd::spinlock::status =not_initialized

inherited

---

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

• dxd_stream_device.h