Struct SIBinder 

pub struct SIBinder { /* private fields */ }

Strong reference to a binder object.

Implementations

impl SIBinder

pub fn new(data: Arc<dyn IBinder>) -> Result<Self>

Wrap an Arc<dyn IBinder> in an SIBinder.

Drives inc_strong on the inner binder. For native binders this advances the local RefCounter.strong; for proxies it is a no-op (proxy ref-count is owned by the cache-pin model — see proxy::ProxyHandle).

pub fn downgrade(this: &Self) -> WIBinder

Construct a weak reference to this binder.

Pure Arc::downgrade — no kernel command, no trait dispatch.

For proxies, the resulting WIBinder snapshots (handle, stability, generation) so a later WIBinder::upgrade() can route through the process-wide proxy cache. As long as the cache pin is alive (no obituary yet), upgrade() succeeds via case-(b) resurrection — matching Android wp<BpBinder>::promote() semantics. If the cache entry was removed (obituary) or the handle id was recycled to a different binder_node (generation mismatch), upgrade() returns Err(DeadObject).

For native binders, the WIBinder is a plain sync::Weak<dyn IBinder> — upgrade() succeeds iff some Arc<dyn IBinder> to the inner binder is still alive.

pub fn stability(&self) -> Stability

Retrieve the stability level of the underlying binder object.

pub fn into_interface<I: FromIBinder + Interface + ?Sized>( self, ) -> Result<Strong<I>>

Try to convert this Binder object into a trait object for the given Binder interface.

If this object does not implement the expected interface, the error StatusCode::BadType is returned.

Methods from Deref<Target = dyn IBinder>

pub fn as_proxy(&self) -> Option<&ProxyHandle>

Convert this binder object into a proxy binder object.

Trait Implementations

impl Clone for SIBinder

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SIBinder

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

Formats the value using the given formatter.

impl Deref for SIBinder

type Target = dyn IBinder

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl Deserialize for SIBinder

fn deserialize(parcel: &mut Parcel) -> Result<Self>

Deserialize an instance from the given Parcel.

fn deserialize_from(&mut self, parcel: &mut Parcel) -> Result<()>

Deserialize an instance from the given Parcel onto the current object. This operation will overwrite the old value partially or completely, depending on how much data is available.

impl DeserializeArray for SIBinder

fn deserialize_array(parcel: &mut Parcel) -> Result<Option<Vec<Self>>>

Deserialize an array of type from the given parcel.

impl DeserializeOption for SIBinder

fn deserialize_option(parcel: &mut Parcel) -> Result<Option<Self>>

Deserialize an Option of this type from the given parcel.

fn deserialize_option_from( this: &mut Option<Self>, parcel: &mut Parcel, ) -> Result<()>

Deserialize an Option of this type from the given parcel onto the current object. This operation will overwrite the current value partially or completely, depending on how much data is available.

impl Drop for SIBinder

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

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

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.

impl PartialEq for SIBinder

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for SIBinder

fn serialize(&self, parcel: &mut Parcel) -> Result<()>

Serialize this instance into the given Parcel.

impl SerializeArray for SIBinder

fn serialize_array(slice: &[Self], parcel: &mut Parcel) -> Result<()>

Serialize an array of this type into the given parcel.

impl SerializeOption for SIBinder

fn serialize_option(this: Option<&Self>, parcel: &mut Parcel) -> Result<()>

Serialize an Option of this type into the given parcel.

impl<B: Remotable + 'static> TryFrom<SIBinder> for Binder<B>

type Error = StatusCode

The type returned in the event of a conversion error.

fn try_from(ibinder: SIBinder) -> Result<Self>

Performs the conversion.

impl Eq for SIBinder