Crate winmtp

Safe Rust abstraction over Windows MTP API

Microsoft provides a COM API for WPD (Windows Portable Devices).
It also provides raw bindings over these COM APIs.

This create provides a safe Rust abstraction over this API.

What is MTP

MTP stands for “Media Transfer Protocol”. This is how many devices expose themselves when plugged by USB.
Most (every?) Android device supports it.

Important note

The WPD API is fairly large. This crate only provides a small fraction of what is possible.
Basically, only device enumeration, simple content enumeration, and content transfer from and to devices that expose disk-like contents are implemented.

Much of this crate implements features from code samples at https://github.com/microsoft/Windows-classic-samples/blob/HEAD/Samples/PortableDeviceCOM/.
Much can be added in the future. Contributions are welcome!

Usage

The entry point of this library is to create a Provider, e.g. by Provider::new. Other structs can be created from its various methods.

Modules

• PortableDevices
  Re-exported from the windows-rs crate, because it is used in our public API.
  Required features: "Win32_Devices_PortableDevices"
• device
• error
• io
  Adapters so that COM streams implement std::io::Read and std::io::Write
• object
  MTP object (can be a folder, a file, etc.)
• utils

Macros

• make_current_app_identifiers
  Create an instance of AppIdentifiers with the values of the current app.

Structs

• PROPERTYKEY
  Re-exported from the windows-rs crate, because it is used in our public API.
  
• Provider
• WindowsError
  Re-exported from the windows-rs crate, because it is used in our public API.
  An error object consists of both an error code as well as detailed error information for debugging.

Type Aliases

• WindowsResult
  Re-exported from the windows-rs crate, because it is used in our public API.
  A specialized Result type that provides Windows error information.