dxd::stream::umap< stream_t > Class Template Reference

stream user mapping More...

#include <dxd_stream.h>

Inheritance diagram for dxd::stream::umap< stream_t >:

Collaboration diagram for dxd::stream::umap< stream_t >:

Public Member Functions
void	free ()
	kernel map free
os_result	initialize (::IOMemoryDescriptor *iokit_memory_descriptor, size_t offset=0)
	IOKit kernel map initializer.
	operator const vm_t * () const
	operator const::IOMemoryMap * () const
	operator vm_t * () const
vm_t *	operator-> ()
const vm_t *	operator-> () const
	operator to use mapping like pointer
	operator::IOMemoryMap * ()
template<typename reference_t >
int	release (reference_t &reference)
void	retain ()
size_t	size () const
	kernel mapping size
os_result	start ()
os_result	stop (bool force=false)
	umap (client &client, const dx::os_event &os_event, stream_t *&stream)
	~umap ()

Public Attributes
dxd::abstract::event &	reference
atomic< int >	references {}
os_result	status =not_initialized
	status of mapping object

Protected Attributes
vm_t *	_vm =nullptr
	kernel virtual address mapping
::IOMemoryMap *	iokit_memory_map =nullptr
atomic< item_t * >	next =nullptr
stream_t *&	stream
	auto nulling reference

Detailed Description

template<typename stream_t = stream>
class dxd::stream::umap< stream_t >

stream user mapping

Constructor & Destructor Documentation

umap()

template<typename stream_t = stream>

dxd::stream::umap< stream_t >::umap ( client & client, const dx::os_event & os_event, stream_t *& stream )

inline

insert broadcast user event

Here is the call graph for this function:

~umap()

template<typename stream_t = stream>

dxd::stream::umap< stream_t >::~umap ( )

inline

remove broadcast user event

releases this stream reference and nulls stream pointer if it was the last reference

Here is the call graph for this function:

Member Function Documentation

free()

template<dx::scope scope_t = dx::kernel, typename vm_t = unsigned int>

void dxd::map< scope_t, vm_t >::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.

initialize()

template<dx::scope scope_t = dx::kernel, typename vm_t = unsigned int>

os_result dxd::map< scope_t, vm_t >::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 call graph for this function:

operator const vm_t *()

template<dx::scope scope_t = dx::kernel, typename vm_t = unsigned int>

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

inlineinherited

operator const::IOMemoryMap *()

template<dx::scope scope_t = dx::kernel, typename vm_t = unsigned int>

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

inlineinherited

operator vm_t *()

template<dx::scope scope_t = dx::kernel, typename vm_t = unsigned int>

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

inlineinherited

operator->() [1/2]

template<dx::scope scope_t = dx::kernel, typename vm_t = unsigned int>

vm_t * dxd::map< scope_t, vm_t >::operator-> ( )

inlineinherited

operator->() [2/2]

template<dx::scope scope_t = dx::kernel, typename vm_t = unsigned int>

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

inlineinherited

operator to use mapping like pointer

operator::IOMemoryMap *()

template<dx::scope scope_t = dx::kernel, typename vm_t = unsigned int>

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

inlineinherited

release()

template<typename reference_t >

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

inlineinherited

retain()

void dxd::referenced::retain ( )

inlineinherited

Here is the caller graph for this function:

size()

template<dx::scope scope_t = dx::kernel, typename vm_t = unsigned int>

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

inlineinherited

kernel mapping size

start()

template<typename stream_t = stream>

os_result dxd::stream::umap< stream_t >::start ( )

inline

Here is the call graph for this function:

stop()

template<typename stream_t = stream>

os_result dxd::stream::umap< stream_t >::stop ( bool force = false )

inline

Here is the call graph for this function:

Here is the caller graph for this function:

Member Data Documentation

_vm

template<dx::scope scope_t = dx::kernel, typename vm_t = unsigned int>

vm_t* dxd::map< scope_t, vm_t >::_vm =nullptr

protectedinherited

kernel virtual address mapping

iokit_memory_map

template<dx::scope scope_t = dx::kernel, typename vm_t = unsigned int>

::IOMemoryMap* dxd::map< scope_t, vm_t >::iokit_memory_map =nullptr

protectedinherited

next

template<typename item_t >

atomic<item_t*> dxd::linked::item< item_t >::next =nullptr

protectedinherited

reference

dxd::abstract::event& dxd::doubly::linked::abstract::event::reference

inherited

references

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

inherited

status

template<dx::scope scope_t = dx::kernel, typename vm_t = unsigned int>

os_result dxd::map< scope_t, vm_t >::status =not_initialized

inherited

status of mapping object

stream

template<typename stream_t = stream>

stream_t*& dxd::stream::umap< stream_t >::stream

protected

auto nulling reference

---

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

• dxd_stream.h