//! Handles COM initialization and cleanup. use super::IoError; use std::marker::PhantomData; use windows::Win32::Foundation::RPC_E_CHANGED_MODE; use windows::Win32::System::Com::{CoInitializeEx, CoUninitialize, COINIT_APARTMENTTHREADED}; thread_local!(static COM_INITIALIZED: ComInitialized = { unsafe { // Try to initialize COM with STA by default to avoid compatibility issues with the ASIO // backend (where CoInitialize() is called by the ASIO SDK) or winit (where drag and drop // requires STA). // This call can fail with RPC_E_CHANGED_MODE if another library initialized COM with MTA. // That's OK though since COM ensures thread-safety/compatibility through marshalling when // necessary. let result = CoInitializeEx(None, COINIT_APARTMENTTHREADED); match result.clone().map_err(|e| e.code()) { Ok(_) | Err(RPC_E_CHANGED_MODE) => { ComInitialized { result, _ptr: PhantomData, } }, Err(e) => { // COM initialization failed in another way, something is really wrong. panic!("Failed to initialize COM: {}", IoError::from_raw_os_error(e.0)); } } } }); /// RAII object that guards the fact that COM is initialized. /// // We store a raw pointer because it's the only way at the moment to remove `Send`/`Sync` from the // object. struct ComInitialized { result: windows::core::Result<()>, _ptr: PhantomData<*mut ()>, } impl Drop for ComInitialized { #[inline] fn drop(&mut self) { // Need to avoid calling CoUninitialize() if CoInitializeEx failed since it may have // returned RPC_E_MODE_CHANGED - which is OK, see above. if self.result.is_ok() { unsafe { CoUninitialize() }; } } } /// Ensures that COM is initialized in this thread. #[inline] pub fn com_initialized() { COM_INITIALIZED.with(|_| {}); }