2 stable releases

2.0.0 Jul 31, 2019
1.5.0 Jan 5, 2019
1.0.1 Dec 31, 2018
0.1.2 Dec 20, 2018

#147 in Windows APIs

MIT/Apache

135KB
3K SLoC

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.18362.0.
  • 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.18362.0\um\virtdisk.h
  • C:\Program Files (x86)\Windows Kits\10\Lib\10.0.18362.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 10.0.17763.132 installed. Then run:

cd virtdisk-rs
cargo build

Finally, open documentation by running:

cargo doc --open

Crates.io version notes

This section briefly describes all published crates.io versions of this project, ordered from latest to oldest.

Dependencies

~3–4.5MB
~72K SLoC