Struct InterfaceRef

pub struct InterfaceRef<'a, I>(/* private fields */);

This has the same memory representation as IFoo, but represents a borrowed interface pointer.

This type has no Drop impl; it does not AddRef/Release the given interface. However, because it has a lifetime parameter, it always represents a non-null pointer to an interface.

Implementations

impl<I> InterfaceRef<'_, I>

where I: Interface,

pub unsafe fn from_raw(ptr: NonNull<c_void>) -> InterfaceRef<'_, I>

Creates an InterfaceRef from a raw pointer. This is extremely dangerous, since there is no lifetime tracking at all!

Safety

The caller must guarantee that the 'a lifetime parameter is bound by context to a correct lifetime.

pub fn from_interface(interface: &I) -> InterfaceRef<'_, I>

Creates an InterfaceRef from an interface reference. This safely associates the lifetime of the interface reference with the 'a parameter of InterfaceRef. This allows for lifetime checking without calling AddRef/Release on the underlying lifetime, which can improve efficiency.

pub fn to_owned(self) -> I

Calls AddRef on the underlying COM interface and returns an “owned” (counted) reference.

Trait Implementations

impl<I> Clone for InterfaceRef<'_, I>

fn clone(&self) -> InterfaceRef<'_, I>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<I> Debug for InterfaceRef<'_, I>

where I: Debug + Interface,

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

Formats the value using the given formatter.

impl<I> Deref for InterfaceRef<'_, I>

where I: Interface,

type Target = I

The resulting type after dereferencing.

fn deref(&self) -> &I

Dereferences the value.

impl<'a, 'i, I> From<&'i I> for InterfaceRef<'a, I>

where 'i: 'a, I: Interface,

fn from(interface: &'a I) -> InterfaceRef<'a, I>

Converts to this type from the input type.

impl<I> Copy for InterfaceRef<'_, I>

impl<T> Param<T> for InterfaceRef<'_, T>

where T: Type<T>,