57 lines
1.9 KiB
Rust
57 lines
1.9 KiB
Rust
//! 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);
|
|
if result.is_ok() || result == RPC_E_CHANGED_MODE {
|
|
ComInitialized {
|
|
result,
|
|
_ptr: PhantomData,
|
|
}
|
|
} else {
|
|
// COM initialization failed in another way, something is really wrong.
|
|
panic!(
|
|
"Failed to initialize COM: {}",
|
|
IoError::from_raw_os_error(result.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::HRESULT,
|
|
_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(|_| {});
|
|
}
|