Struct windows_core::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<'a, I: Interface> InterfaceRef<'a, I>

pub unsafe fn from_raw(ptr: NonNull<c_void>) -> Self

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) -> Self

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<'a, I> Clone for InterfaceRef<'a, I>

fn clone(&self) -> Self

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<'a, I: Debug + Interface> Debug for InterfaceRef<'a, I>

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

Formats the value using the given formatter.

impl<'a, I: Interface> Deref for InterfaceRef<'a, I>

type Target = I

The resulting type after dereferencing.

fn deref(&self) -> &I

Dereferences the value.

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

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

Converts to this type from the input type.

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