Struct pir_8_emu::binutils::pir_8_emu::RawNativePortHandler

pub struct RawNativePortHandler {
    pub port_count: extern "C" fn() -> u8,
    pub init: extern "C" fn(ports: *const u8, ports_len: u8) -> *mut c_void,
    pub uninit: extern "C" fn(state: *mut c_void),
    pub handle_read: extern "C" fn(state: *mut c_void, port: u8) -> u8,
    pub handle_write: extern "C" fn(state: *mut c_void, port: u8, byte: u8),
}

Raw C funxion pointers into a loaded DLL

The raw in-/exported names are prefixed with pir_8_emu_

Consult PortHandler for timings and invariants

These correspond to the following C declaration set:

unsigned char pir_8_emu_port_count();

void * pir_8_emu_init(const unsigned char * ports, unsigned char ports_len);

void pir_8_emu_uninit(void * state);

unsigned char pir_8_emu_handle_read(void * state, unsigned char port);

void pir_8_emu_handle_write(void * state, unsigned char port, unsigned char byte);

These can also be obtained from the include/pir-8-emu/port_handler.h file in the git repo

Fields

port_count: extern "C" fn() -> u8

Get the amount of ports this handler handles

Returning 0 from this funxion will panic

init: extern "C" fn(ports: *const u8, ports_len: u8) -> *mut c_void

Get the handler-allocated state corresponding to the specified ports set

It is valid to return nullptr from this funxion

The ports_len argument will always be equal to the last return value of port_count()

uninit: extern "C" fn(state: *mut c_void)

Release all resources associated with the specified state

The state argument will always be equal to the one returned from init()

handle_read: extern "C" fn(state: *mut c_void, port: u8) -> u8

Handle the program reading from one of the handled ports

The port argument will always have been contained within the set passed to init()

The state argument will always be equal to the one returned from init()

handle_write: extern "C" fn(state: *mut c_void, port: u8, byte: u8)

Handle the program writing to one of the handled ports

The port argument will always have been contained within the set passed to init()

The state argument will always be equal to the one returned from init()

Methods

impl RawNativePortHandler

pub const PORT_COUNT_NAME: ConstCStr

pub const INIT_NAME: ConstCStr

pub const UNINIT_NAME: ConstCStr

pub const HANDLE_READ_NAME: ConstCStr

pub const HANDLE_WRITE_NAME: ConstCStr

Trait Implementations

impl Clone for RawNativePortHandler

fn clone(&self) -> RawNativePortHandler

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for RawNativePortHandler

impl Debug for RawNativePortHandler

fn fmt(&self, f: &mut Formatter) -> Result

Formats the value using the given formatter.

impl Eq for RawNativePortHandler

impl Hash for RawNativePortHandler

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given [Hasher].

fn hash_slice<H>(data: &[Self], state: &mut H) where
    H: Hasher, 

Feeds a slice of this type into the given [Hasher].

impl Ord for RawNativePortHandler

fn cmp(&self, other: &RawNativePortHandler) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

🔬 This is a nightly-only experimental API. (clamp)

Restrict a value to a certain interval.

impl PartialEq<RawNativePortHandler> for RawNativePortHandler

fn eq(&self, other: &RawNativePortHandler) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &RawNativePortHandler) -> bool

This method tests for !=.

impl PartialOrd<RawNativePortHandler> for RawNativePortHandler

fn partial_cmp(&self, other: &RawNativePortHandler) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &RawNativePortHandler) -> bool

This method tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &RawNativePortHandler) -> bool

This method tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &RawNativePortHandler) -> bool

This method tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &RawNativePortHandler) -> bool

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl StructuralEq for RawNativePortHandler

impl StructuralPartialEq for RawNativePortHandler