Same Volume Checker

使用中文的开发者可以跳转至下方的中文文档。

A lightweight Windows utility for determining if two paths reside on the same storage volume.

Features

• 🚀 Fast volume GUID comparison using Windows API
• 📌 Automatically handles path normalization and mount point resolution
• 🔄 Built-in volume mapping cache with manual refresh
• 🛡️ Safe error handling for invalid paths
• 💽 Supports physical drives, VHD(X) mounts, and network paths (UNC)

Installation

Add to your Cargo.toml:

cargo add samevol

Usage

Basic example:

use samevol::is_same_vol;

fn main() {
    let path1 = r"C:\Windows\System32";
    let path2 = r"D:\Data\test.txt";
    
    println!("Same volume? {}", is_same_vol(path1, path2)); // false
}

Force refresh volume mappings:

use samevol::reinitialize_volume_map;

fn main() {
    // After system storage configuration changes
    let count = reinitialize_volume_map().expect("Failed to refresh mappings");
    println!("Reloaded {} volume mappings", count);
}

Contributing

Issues and PRs are welcome!

Note: Due to the limitations of the maintainer's English proficiency, the existing code comments are primarily in Chinese, the maintainer's language.

Copyright and License

Apache 2.0 © 2025 爱佐 (Ayrzo)

This repository is licensed under the Apache 2.0 License. See the LICENSE file for details.

AI usage notice: Portions of the codebase, comments, and documentation were written with assistance from DeepSeek AI.

同一存储卷检查器

轻量级 Windows 工具库，用于检测两个路径是否位于同一存储卷。

功能特性

• 🚀 基于 Windows API 的快速卷 GUID 比较
• 📌 自动处理路径规范化和挂载点解析
• 🔄 内置卷映射缓存支持手动刷新
• 🛡️ 安全的无效路径错误处理
• 💽 支持物理驱动器、VHD(X) 虚拟硬盘及网络路径 (UNC)

安装

添加到 Cargo.toml:

cargo add samevol

使用示例

基础用法:

use samevol::is_same_vol;

fn main() {
    let path1 = r"C:\Windows\System32";
    let path2 = r"D:\Data\test.txt";
    
    println!("是否同一卷? {}", is_same_vol(path1, path2)); // false
}

强制刷新卷映射:

use samevol::reinitialize_volume_map;

fn main() {
    // 系统存储配置变更后调用
    let count = reinitialize_volume_map().expect("映射刷新失败");
    println!("已重新加载 {} 个卷映射", count);
}

贡献指南

欢迎提交 issue 和 PR！

著作权和开源协议

Apache 2.0 © 2025 爱佐

本存储库根据 Apache 2.0 许可证授权。有关详细信息，请参阅 LICENSE 文件。

人工智能使用说明：部分代码、注释和文档是在 深度求索 DeepSeek AI 的辅助下编写的。