# Crate Features
| Crate Feature | Description |
| --------------------------| --------------|
| `"undocumented"` | Enable undocumented XInput APIs which are exported by ordinal such as:
[`get_state_ex`], [`power_off_controller`], ...
|
| | **Features for interop with other crates:** (e.g. [`AsRef`], [`AsMut`], [`From`], [`Into`] for all C++ `struct`s)
| `"winapi-0-x"` | Interop with [`winapi`](https://docs.rs/winapi/)
| `"windows-0-xx"` | Interop with [`windows`](https://microsoft.github.io/windows-docs-rs/doc/windows/)
| `"windows-sys-0-xx"` | Interop with [`windows-sys`](https://docs.rs/windows-sys/)
|
| | **Internal features not meant for stable code:** (although they should be safe for `--all-features`)
| `"xxx-docs"` | Defines what should appear on [docs.rs](https://docs.rs/thindx-xinput/). Likely to define only the latest `windows-xxx` feature.
|
| | **Exact interop features:**
|
| `"winapi-0-3"` | Interop with [`winapi = "0.3"`](https://docs.rs/winapi/0.3/)
| `"winapi-0-2"` | Interop with [`winapi = "0.2"`](https://docs.rs/winapi/0.2/x86_64-pc-windows-gnu/winapi/) [⚠️ Interop Errata]
| ~~`"winapi-0-1"`~~ | ~~Interop with [`winapi = "0.1"`](https://docs.rs/winapi/0.1/x86_64-pc-windows-msvc/winapi/)~~ (this version of `winapi` doesn't compile on modern rustc)
|
| `"windows-0-52"` | Interop with `windows = "0.52"`
| `"windows-0-51"` | Interop with `windows = "0.51"`
| `"windows-0-48"` | Interop with `windows = "0.48"`
| ~~`"windows-0-47"`~~ | ~~Interop with `windows = "0.47"`~~ (this version of `windows` was yanked)
| `"windows-0-46"` | Interop with `windows = "0.46"`
| `"windows-0-44"` | Interop with `windows = "0.44"`
| `"windows-0-43"` | Interop with `windows = "0.43"` [⚠️ Interop Errata]
| `"windows-0-42"` | Interop with `windows = "0.42"` [⚠️ Interop Errata]
| `"windows-0-41"` | Interop with `windows = "0.41"` [⚠️ Interop Errata]
| `"windows-0-40"` | Interop with `windows = "0.40"` [⚠️ Interop Errata]
| `"windows-0-39"` | Interop with `windows = "0.39"` [⚠️ Interop Errata]
| `"windows-0-38"` | Interop with `windows = "0.38"` [⚠️ Interop Errata]
| `"windows-0-37"` | Interop with `windows = "0.37"` [⚠️ Interop Errata]
| `"windows-0-36"` | Interop with `windows = "0.36"` [⚠️ Interop Errata]
| `"windows-0-35"` | Interop with `windows = "0.35"` [⚠️ Interop Errata]
| `"windows-0-34"` | Interop with `windows = "0.34"` [⚠️ Interop Errata]
| `"windows-0-33"` | Interop with `windows = "0.33"` [⚠️ Interop Errata]
| `"windows-0-32"` | Interop with `windows = "0.32"` [⚠️ Interop Errata]
| ~~`"windows-0-31"`~~ | ~~Interop with `windows = "0.31"`~~ (this version of `windows` was yanked)
| `"windows-0-30"` | Interop with `windows = "0.30"` [⚠️ Interop Errata]
| `"windows-0-29"` | Interop with `windows = "0.29"` [⚠️ Interop Errata]
| `"windows-0-28"` | Interop with `windows = "0.28"` [⚠️ Interop Errata]
| `"windows-0-27"` | Interop with `windows = "0.27"` [⚠️ Interop Errata]
| `"windows-0-26"` | Interop with `windows = "0.26"` [⚠️ Interop Errata]
| `"windows-0-25"` | Interop with `windows = "0.25"` [⚠️ Interop Errata]
| `"windows-0-24"` | Interop with `windows = "0.24"` [⚠️ Interop Errata]
| `"windows-0-23"` | Interop with `windows = "0.23"` [⚠️ Interop Errata]
| `"windows-0-22"` | Interop with `windows = "0.22"` [⚠️ Interop Errata]
| ~~`"windows-0-21"`~~ | (codegen-only crate, not suitable as a crates.io dependency)
|
| \"windows-sys-0-52\" | Interop with [`windows-sys = "0.52"`](https://docs.rs/windows-sys/0.52/)
| `"windows-sys-0-48"` | Interop with [`windows-sys = "0.48"`](https://docs.rs/windows-sys/0.48/)
| `"windows-sys-0-45"` | Interop with [`windows-sys = "0.45"`](https://docs.rs/windows-sys/0.45/)
| `"windows-sys-0-42"` | Interop with [`windows-sys = "0.42"`](https://docs.rs/windows-sys/0.42/) [⚠️ Interop Errata]
| `"windows-sys-0-36"` | Interop with [`windows-sys = "0.36"`](https://docs.rs/windows-sys/0.36/) [⚠️ Interop Errata]
| `"windows-sys-0-35"` | Interop with [`windows-sys = "0.35"`](https://docs.rs/windows-sys/0.35/) [⚠️ Interop Errata]
| `"windows-sys-0-34"` | Interop with [`windows-sys = "0.34"`](https://docs.rs/windows-sys/0.34/) [⚠️ Interop Errata]
| `"windows-sys-0-33"` | Interop with [`windows-sys = "0.33"`](https://docs.rs/windows-sys/0.33/) [⚠️ Interop Errata]
| `"windows-sys-0-32"` | Interop with [`windows-sys = "0.32"`](https://docs.rs/windows-sys/0.32/) [⚠️ Interop Errata]
| ~~`"windows-sys-0-31"`~~ | ~~Interop with [`windows-sys = "0.32"`](https://docs.rs/windows-sys/0.31/)~~ (this version of `windows-sys` was yanked)
| `"windows-sys-0-30"` | Interop with [`windows-sys = "0.30"`](https://docs.rs/windows-sys/0.30/) [⚠️ Interop Errata]
| `"windows-sys-0-29"` | Interop with [`windows-sys = "0.29"`](https://docs.rs/windows-sys/0.29/) [⚠️ Interop Errata]
| `"windows-sys-0-28"` | Interop with `windows-sys = "0.28"` [⚠️ Interop Errata] (missing a useful docs.rs)
| `"windows-sys-0-27"` | Interop with `windows-sys = "0.27"` [⚠️ Interop Errata]
# Interop Errata
Multiple crates misdefine XInput structures.
While this crate often *could* still implement some [`From`] / [`Into`] conversions (via truncation of mis-sized fields etc.), the use of these broken-ABI types suggests a likelyhood of FFI interop bugs.
To help catch these bugs, interop for these types - when their ABIs are incorrect - is simply not implemented.
Interop for versions of the crates where the ABIs are correct is implemented as usual.
* [`winapi`](https://docs.rs/winapi/) before `0.3.0` misdefines `XINPUT_KEYSTROKE` as missing a `Flags` field.
* [`windows`](https://microsoft.github.io/windows-docs-rs/doc/windows/) before `0.44.0` and [`windows-sys`](https://docs.rs/windows-sys/) before `0.45.0` misdefine fields of `XINPUT_BATTERY_INFORMATION` and `XINPUT_CAPABILITIES` as [`u32`]s instead of [`u8`]s.
[⚠️ Interop Errata]: #interop-errata