virtdisk-rs

Rust wrapper of VirtDisk APIs

Overview

This project is a collection of Rust libraries that wrap functionality exposed by VirtDisk.

VirtDisk APIs are part of the Windows 10 SDK.

NOTE:This crate is untested and simply provides safe Rust abstractions to the virtdisk C bindings. Fixes might come at later updates to the crate. There is no plan for now to create a fully suited integration test for the APIs.

Requirements

For this wrapper to build properly, the following requirements need to be met by the building machine:

• Windows 10 SDK version 10.0.17763.132.
• amd64 architecture.
  • This Rust wrapper, for now, expects to build only in amd64.

Wrapped Windows 10 SDK APIs

Note: This section includes the paths in the Windows SDK for the header and lib files based on the default installation path c:\Program Files (x86)\Windows Kits\10.

The relevant Windows 10 SDK files that this project is wrapping are: - C:\Program Files (x86)\Windows Kits\10\Include\10.0.17763.0\um\virtdisk.h - C:\Program Files (x86)\Windows Kits\10\Lib\10.0.17763.0\um\x64\virtdisk.lib - C:\Windows\System32\virtdisk.dll

How to use locally

Clone the repo to a folder:

git clone https://github.com/rafawo/virtdisk-rs.git

Make sure the machine where you are building has Windows 10 SDK version Windows 10 SDK version 10.0.17763.132 installed. Then run:

cd virtdisk-rs cargo build

Finally, open documentation by running: cargo doc --open