diff options
| author | mo khan <mo@mokhan.ca> | 2025-07-02 18:36:06 -0600 |
|---|---|---|
| committer | mo khan <mo@mokhan.ca> | 2025-07-02 18:36:06 -0600 |
| commit | 8cdfa445d6629ffef4cb84967ff7017654045bc2 (patch) | |
| tree | 22f0b0907c024c78d26a731e2e1f5219407d8102 /vendor/windows-core/src/agile_reference.rs | |
| parent | 4351c74c7c5f97156bc94d3a8549b9940ac80e3f (diff) | |
chore: add vendor directory
Diffstat (limited to 'vendor/windows-core/src/agile_reference.rs')
| -rw-r--r-- | vendor/windows-core/src/agile_reference.rs | 39 |
1 files changed, 39 insertions, 0 deletions
diff --git a/vendor/windows-core/src/agile_reference.rs b/vendor/windows-core/src/agile_reference.rs new file mode 100644 index 00000000..30554e97 --- /dev/null +++ b/vendor/windows-core/src/agile_reference.rs @@ -0,0 +1,39 @@ +use super::*; +use core::marker::PhantomData; + +/// A type representing an agile reference to a COM/WinRT object. +#[repr(transparent)] +#[derive(Clone, PartialEq, Eq)] +pub struct AgileReference<T>(imp::IAgileReference, PhantomData<T>); + +impl<T: Interface> AgileReference<T> { + /// Creates an agile reference to the object. + pub fn new(object: &T) -> Result<Self> { + // TODO: this assert is required until we can catch this at compile time using an "associated const equality" constraint. + // For example, <T: Interface<UNKNOWN = true>> + // https://github.com/rust-lang/rust/issues/92827 + assert!(T::UNKNOWN); + unsafe { + imp::RoGetAgileReference( + imp::AGILEREFERENCE_DEFAULT, + &T::IID, + core::mem::transmute::<&T, &IUnknown>(object), + ) + .map(|reference| Self(reference, Default::default())) + } + } + + /// Retrieves a proxy to the target of the `AgileReference` object that may safely be used within any thread context in which get is called. + pub fn resolve(&self) -> Result<T> { + unsafe { self.0.Resolve() } + } +} + +unsafe impl<T: Interface> Send for AgileReference<T> {} +unsafe impl<T: Interface> Sync for AgileReference<T> {} + +impl<T> core::fmt::Debug for AgileReference<T> { + fn fmt(&self, f: &mut core::fmt::Formatter<'_>) -> core::fmt::Result { + write!(f, "AgileReference({:?})", &self.0) + } +} |
