feat!: expand wdk-sys coverage to include hid-related headers

.github/workflows/build.yaml

@@ -73,7 +73,7 @@ jobs:
           targets: ${{ matrix.target_triple }}
 
       - name: Run Cargo Build
-        run: cargo +${{ matrix.rust_toolchain }} build --locked --profile ${{ matrix.cargo_profile }} --target ${{ matrix.target_triple }} --workspace
+        run: cargo +${{ matrix.rust_toolchain }} build --locked --profile ${{ matrix.cargo_profile }} --target ${{ matrix.target_triple }} --workspace --all-features
 
       - name: Install Cargo Make
         uses: taiki-e/install-action@v2

.github/workflows/code-formatting-check.yaml

@@ -6,7 +6,6 @@ on:
   schedule: # Trigger a job on default branch at 4AM PST everyday
     - cron: 0 11 * * *
 
-
 jobs:
   cargo-fmt:
     name: .rs Formatting Check

.github/workflows/codeql.yml

@@ -89,7 +89,7 @@ jobs:
 
     - if: matrix.build-mode == 'manual'
       working-directory: ./examples
-      run: cargo +${{ matrix.rust_toolchain }} make default --locked --profile ${{ matrix.cargo_profile }} --target ${{ matrix.target_triple }} --workspace
+      run: cargo +${{ matrix.rust_toolchain }} make default --locked --profile ${{ matrix.cargo_profile }} --target ${{ matrix.target_triple }} --workspace --all-features
 
     - name: Perform CodeQL Analysis
       uses: github/codeql-action/analyze@v3

.github/workflows/docs.yaml

@@ -72,19 +72,9 @@ jobs:
 
       - name: Run Cargo Doc
         # proc-macro crates must be excluded to avoid cargo doc bug: https://github.com/rust-lang/cargo/issues/10368
-        run: cargo +${{ matrix.rust_toolchain }} doc --locked --profile ${{ matrix.cargo_profile }} --target ${{ matrix.target_triple }} --workspace --exclude wdk-macros
-
-      - name: Run Cargo Doc (--features nightly)
-        if: matrix.rust_toolchain == 'nightly'
-        # proc-macro crates must be excluded to avoid cargo doc bug: https://github.com/rust-lang/cargo/issues/10368
-        run: cargo +${{ matrix.rust_toolchain }} doc --locked --profile ${{ matrix.cargo_profile }} --target ${{ matrix.target_triple }} --workspace --exclude wdk-macros --features nightly
+        run: cargo +${{ matrix.rust_toolchain }} doc --locked --profile ${{ matrix.cargo_profile }} --target ${{ matrix.target_triple }} --workspace --exclude wdk-macros --all-features
 
       - name: Run Cargo Doc w/ proc-macro crates
         if: matrix.target_triple == 'x86_64-pc-windows-msvc'
         # cargo doc can only generate documentation for proc-macro crates when --target is not specified due to a cargo doc bug: https://github.com/rust-lang/cargo/issues/7677
-        run: cargo +${{ matrix.rust_toolchain }} doc --locked --profile ${{ matrix.cargo_profile }}
-
-      - name: Run Cargo Doc w/ proc-macro crates (--features nightly)
-        if: ${{ matrix.target_triple == 'x86_64-pc-windows-msvc' && matrix.rust_toolchain == 'nightly' }}
-        # cargo doc can only generate documentation for proc-macro crates when --target is not specified due to a cargo doc bug: https://github.com/rust-lang/cargo/issues/7677
-        run: cargo +${{ matrix.rust_toolchain }} doc --locked --profile ${{ matrix.cargo_profile }} --features nightly
+        run: cargo +${{ matrix.rust_toolchain }} doc --locked --profile ${{ matrix.cargo_profile }} --all-features

.github/workflows/lint.yaml

@@ -7,6 +7,10 @@ on:
 
 name: Lint
 
+env:
+  RUSTFLAGS: >-
+    -D warnings
+
 jobs:
   clippy:
     name: Clippy
@@ -71,11 +75,7 @@ jobs:
           targets: ${{ matrix.target_triple }}
 
       - name: Run Cargo Clippy
-        run: cargo +${{ matrix.rust_toolchain }} clippy --locked --profile ${{ matrix.cargo_profile }} --target ${{ matrix.target_triple }} --all-targets -- -D warnings
-
-      - name: Run Cargo Clippy (--features nightly)
-        if: matrix.rust_toolchain == 'nightly'
-        run: cargo +${{ matrix.rust_toolchain }} clippy --locked --profile ${{ matrix.cargo_profile }} --target ${{ matrix.target_triple }} --all-targets --features nightly -- -D warnings
+        run: cargo +${{ matrix.rust_toolchain }} clippy --locked --profile ${{ matrix.cargo_profile }} --target ${{ matrix.target_triple }} --all-targets --all-features
 
   unused_deps:
     name: Detect Unused Cargo Dependencies

.github/workflows/test.yaml

@@ -73,8 +73,4 @@ jobs:
           tool: [email protected]
 
       - name: Run Cargo Test
-        run: cargo +${{ matrix.rust_toolchain }} test --locked --profile ${{ matrix.cargo_profile }} --target ${{ matrix.target_triple }}
-
-      - name: Run Cargo Test (--features nightly)
-        if: matrix.rust_toolchain == 'nightly'
-        run: cargo +${{ matrix.rust_toolchain }} test --locked --profile ${{ matrix.cargo_profile }} --target ${{ matrix.target_triple }} --features nightly
+        run: cargo +${{ matrix.rust_toolchain }} test --locked --profile ${{ matrix.cargo_profile }} --target ${{ matrix.target_triple }} --all-features

.vscode/settings.json

@@ -19,5 +19,6 @@
     "./tests/umdf-driver-workspace/Cargo.toml",
     "./tests/wdk-macros-tests/Cargo.toml",
     "./tests/wdk-sys-tests/Cargo.toml",
-  ]
-}
+  ],
+  "rust-analyzer.cargo.features": "all"
+}

CONTRIBUTING.md

@@ -96,9 +96,8 @@ The following tools should be installed as a part of the `windows-drivers-rs` de
 
 ### Generating Documentation
 
-* To compile and open documentation: `cargo doc --locked --open`
-  * To include nightly features: `cargo +nightly doc --locked --open --features nightly`
-  * To open docs for non-host architecture: `cargo doc --locked --open --target <target-triple> --workspace --exclude wdk-macros`
+* To compile and open documentation: `cargo doc --locked --all-features --open`
+  * To open docs for non-host architecture: `cargo doc --locked --all-features --open --target <target-triple> --workspace --exclude wdk-macros`
     * `--target` is incompatible with `proc-macro` crates due to a [cargo bug](https://github.com/rust-lang/cargo/issues/10368)
 
 ### Policy on using Nightly/Unstable Features
@@ -113,7 +112,7 @@ The crates in this repository are designed to work with `stable` rust. Some of t
 
 ### Build and Test
 
-To **only build** the workspace: `cargo build`
+To **only build** the workspace: `cargo build --locked --all-features`
 
 To **both** build and package the samples in the workspace: `cargo make --cwd .\crates\<driver-name>`
 
@@ -123,13 +122,13 @@ To maintain the quality of code, tests and tools are required to pass before con
 
 **_Functional Correctness:_**
 
-* `cargo test --locked`
+* `cargo test --locked --all-features`
   * To test `nightly` features: `cargo +nightly test --locked --features nightly`
 
 **_Static Analysis and Linting:_**
 
-* `cargo clippy --locked --all-targets -- -D warnings`
-  * To lint `nightly` features: `cargo +nightly clippy --locked --all-targets --features nightly -- -D warnings`
+* `cargo clippy --locked --all-features --all-targets -- -D warnings`
+  * To lint `nightly` features: `cargo +nightly clippy --locked --all-features --all-targets --features nightly -- -D warnings`
 
 **_Formatting:_**
 
@@ -146,8 +145,7 @@ To maintain the quality of code, tests and tools are required to pass before con
 
 **_Rust Documentation Build Test_**
 
-* `cargo doc --locked`
-  * To build docs for `nightly` features: `cargo +nightly doc --locked --features nightly`
+* `cargo doc --locked --all-features`
 
 ### A Note on Code-Style
 

Cargo.toml

@@ -37,7 +37,7 @@ wdk-sys = { path = "crates/wdk-sys", version = "0.3.0" }
 
 # External Crates
 anyhow = "1.0.95"
-bindgen = "0.69.4"
+bindgen = "0.69.5"
 camino = "1.1.9"
 cargo_metadata = "0.18.1"
 cc = "1.2.10"

Makefile.toml

@@ -6,9 +6,10 @@ additional_profiles = ["all-default-tasks"]
 
 [env]
 CARGO_MAKE_SKIP_SLOW_SECONDARY_FLOWS = false
-CARGO_MAKE_CLIPPY_ARGS = "--all-targets -- -D warnings"
-RUSTFLAGS = "-D warnings"
+CARGO_MAKE_CARGO_BUILD_TEST_FLAGS = "${CARGO_MAKE_CARGO_ALL_FEATURES}"
+CARGO_MAKE_CLIPPY_ARGS = "--all-targets --all-features"
 CARGO_MAKE_RUST_DEFAULT_TOOLCHAIN = "stable"
+RUSTFLAGS = "-D warnings"
 RUSTDOCFLAGS = "-D warnings"
 
 [tasks.wdk-pre-commit-flow]
@@ -71,12 +72,10 @@ alias = "pre-test"
 
 [tasks.nightly-test]
 extend = "test"
-env = { CARGO_MAKE_CARGO_BUILD_TEST_FLAGS = "--features nightly" }
 toolchain = "nightly"
 
 [tasks.post-nightly-test]
 extend = "post-test"
-env = { CARGO_MAKE_CARGO_BUILD_TEST_FLAGS = { unset = true } }
 
 [tasks.nightly-clippy-flow]
 extend = "clippy-flow"

crates/wdk-build/src/bindgen.rs

@@ -20,10 +20,7 @@ pub trait BuilderExt {
     ///
     /// Implementation may return `wdk_build::ConfigError` if it fails to create
     /// a builder
-    fn wdk_default(
-        c_header_files: Vec<&str>,
-        config: impl Borrow<Config>,
-    ) -> Result<Builder, ConfigError>;
+    fn wdk_default(config: impl Borrow<Config>) -> Result<Builder, ConfigError>;
 }
 
 #[derive(Debug)]
@@ -39,19 +36,10 @@ impl BuilderExt for Builder {
     ///
     /// Will return `wdk_build::ConfigError` if any of the resolved include or
     /// library paths do not exist
-    fn wdk_default(
-        c_header_files: Vec<&str>,
-        config: impl Borrow<Config>,
-    ) -> Result<Self, ConfigError> {
+    fn wdk_default(config: impl Borrow<Config>) -> Result<Self, ConfigError> {
         let config = config.borrow();
 
-        let mut builder = Self::default();
-
-        for c_header in c_header_files {
-            builder = builder.header(c_header);
-        }
-
-        builder = builder
+        let builder = Self::default()
             .use_core() // Can't use std for kernel code
             .derive_default(true) // allows for default initializing structs
             // CStr types are safer and easier to work with when interacting with string constants
@@ -60,7 +48,7 @@ impl BuilderExt for Builder {
             // Building in eWDK can pollute system search path when clang-sys tries to detect
             // c_search_paths
             .detect_include_paths(false)
-            .clang_args(config.get_include_paths()?.iter().map(|include_path| {
+            .clang_args(config.include_paths()?.map(|include_path| {
                 format!(
                     "--include-directory={}",
                     include_path
@@ -70,7 +58,7 @@ impl BuilderExt for Builder {
             }))
             .clang_args(
                 config
-                    .get_preprocessor_definitions_iter()
+                    .preprocessor_definitions()
                     .map(|(key, value)| {
                         format!(
                             "--define-macro={key}{}",