Struct comedy::com::ComRef

#[repr(transparent)]
pub struct ComRef<T>(_)
 where
    T: Interface;

Wrap COM interfaces sanely

Originally from wio-rs ComPtr

Methods

impl<T> ComRef<T> where
    T: Interface, 

pub unsafe fn from_raw(ptr: NonNull<T>) -> ComRef<T>

Creates a ComRef to wrap a raw pointer. It takes ownership over the pointer which means it does not call AddRef. T must be a COM interface that inherits from IUnknown.

pub fn up<U>(self) -> ComRef<U> where
    T: Deref<Target = U>,
    U: Interface, 

Casts up the inheritance chain

pub fn into_raw(self) -> NonNull<T>

Extracts the raw pointer. You are now responsible for releasing it yourself.

pub fn cast<U>(&self) -> Result<ComRef<U>, HResult> where
    U: Interface, 

Get another interface via QueryInterface.

If the call to QueryInterface fails or the resulting interface is null, return an error.

pub fn as_raw(&self) -> NonNull<T>

Obtains the raw pointer without transferring ownership.

Do not release this pointer because it is still owned by the ComRef.

Do not use this pointer beyond the lifetime of the ComRef.

pub fn as_raw_ptr(&self) -> *mut T

Obtains the raw pointer without transferring ownership.

Do not release this pointer because it is still owned by the ComRef.

Do not use this pointer beyond the lifetime of the ComRef.

Trait Implementations

impl<T> Drop for ComRef<T> where
    T: Interface, 

fn drop(&mut self)

Executes the destructor for this type.

impl<T> Clone for ComRef<T> where
    T: Interface, 

fn clone(&self) -> Self

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<T> Deref for ComRef<T> where
    T: Interface, 

type Target = T

The resulting type after dereferencing.

fn deref(&self) -> &T

Dereferences the value.