summaryrefslogtreecommitdiff
path: root/vendor/windows-core/src/agile_reference.rs
diff options
context:
space:
mode:
authormo khan <mo@mokhan.ca>2025-07-02 18:36:06 -0600
committermo khan <mo@mokhan.ca>2025-07-02 18:36:06 -0600
commit8cdfa445d6629ffef4cb84967ff7017654045bc2 (patch)
tree22f0b0907c024c78d26a731e2e1f5219407d8102 /vendor/windows-core/src/agile_reference.rs
parent4351c74c7c5f97156bc94d3a8549b9940ac80e3f (diff)
chore: add vendor directory
Diffstat (limited to 'vendor/windows-core/src/agile_reference.rs')
-rw-r--r--vendor/windows-core/src/agile_reference.rs39
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)
+ }
+}