callcomapi 0.1.3

A facade crate for callcomapi, simplifying Use of macros.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48

# callcomapi


[![crates.io](https://img.shields.io/crates/v/callcomapi.svg)](https://crates.io/crates/callcomapi)

`callcomapi` 是一个简化从 Rust 调用 Windows COM API 的库。它提供了一些过程宏，用于管理 COM 的初始化、反初始化以及线程分发。

## 特性


- **单一依赖**：只需导入 `callcomapi` 即可获得宏和运行时支持。
- `#[with_com]` – 在函数周围初始化和反初始化 COM。
- `#[com_thread]` – 将函数调度到专用的后台 COM 线程上执行，支持同步和异步代码。

## 快速开始


在 `Cargo.toml` 中添加：

```toml
[dependencies]
callcomapi = "0.1"
```

使用示例：

```rust
use callcomapi::prelude::*;

#[with_com]

fn example() {
    // COM 将自动初始化，并在退出作用域时反初始化。
}

#[com_thread]

fn on_bg_thread() {
    // 在专用的 STA(默认) 线程(可重用)上执行。
}
```

## 示例


请参阅 [`examples/`](examples/) 目录：

- [`with_com.rs`](examples/with_com.rs): 基础用法
- [`com_thread.rs`](examples/com_thread.rs): 跨线程调用

## 实现 crates


- **[callcomapi_macros](https://crates.io/crates/callcomapi_macros)**:提供 `#[with_com]` 和 `#[com_thread]` 宏，以简化 Windows COM 的开发工作。
- **[callcomapi_runtime](https://crates.io/crates/callcomapi_runtime)**: 实现了 `callcomapi_macros` 所需的后台线程管理、消息传递