feat(cargo-wdk): add --target-platform option to the build command

[Shravan Vasista (svasista-ms)]

Pull request overview

Adds an explicit --target-platform switch to cargo wdk build so users can control which InfVerif validation mode is used when verifying the pacakge's INF.

The option mirrors the Target Platform setting in Visual Studio (Configuration Properties → Driver Settings):

--target-platform	InfVerif mode	Validates against
desktop	/h	WHQL signature requirements
universal (default)	/u	Universal driver requirements
windows-driver	/w	Windows Driver requirements

Changes

• Introduces the --target-platform CLI argument (kebab-case, case-insensitive) and plumbs it through BuildAction into PackageTask.
• Adds a TargetPlatform enum that maps each platform to its InfVerif mode flag.
• Updates the tests and README.

⚠️ Behavior change

When --target-platform is not specified, the InfVerif mode now defaults to universal (/u) for all driver models, matching the Visual Studio's defaults.

Previously the mode was derived from the driver model (KMDF/WDM → /w, UMDF → /u). KMDF/WDM drivers built without the new flag will now be validated with /u instead of /w. To retain the previous validation, pass --target-platform windows-driver.

Notes

• InfVerif accepts only one mode at a time, so --target-platform selects exactly one.
• Support for additional InfVerif switches (e.g. /rulever, /wbuild) via an --infverif-args passthrough is intentionally deferred to a follow-up PR, where it can include validation to prevent specifying multiple modes.

Screenshots

Resolves #490.

[Copilot]

Pull request overview

Adds an explicit --target-platform switch to cargo wdk build so users can control which InfVerif mode flag is used (/h, /u, /w), addressing the “Desktop drivers need /h” scenario from #490.

Changes:

• Introduces --target-platform CLI argument and plumbs it through BuildAction into PackageTask.
• Adds a TargetPlatform enum and uses it to select the infverif mode flag (with UMDF default behavior conditional on detected WDK build number).
• Updates tests and README documentation to cover the new option and the default derivation logic.

Reviewed changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated 6 comments.

Show a summary per file

File	Description
crates/cargo-wdk/src/cli.rs	Adds --target-platform parsing and maps CLI enum to internal TargetPlatform.
crates/cargo-wdk/src/actions/build/mod.rs	Threads target_platform through build action params into packaging.
crates/cargo-wdk/src/actions/build/package_task.rs	Implements TargetPlatform and uses it to select InfVerif mode flag; adds UMDF build-number-based default and tests.
crates/cargo-wdk/src/actions/build/tests.rs	Extends build-action tests to cover overriding InfVerif mode via target_platform.
crates/cargo-wdk/README.md	Documents the new flag and how default InfVerif mode is derived.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Codecov Comments Bot (codecov-commenter)]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 80.42%. Comparing base (a96fd81) to head (c085483).

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #683      +/-   ##
==========================================
+ Coverage   79.93%   80.42%   +0.48%     
==========================================
  Files          26       26              
  Lines        5633     5721      +88     
  Branches     5633     5721      +88     
==========================================
+ Hits         4503     4601      +98     
+ Misses       1002      992      -10     
  Partials      128      128              

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[Copilot]

Pull request overview

Copilot reviewed 5 out of 5 changed files in this pull request and generated 3 comments.

[Copilot]

Pull request overview

Copilot reviewed 5 out of 5 changed files in this pull request and generated 3 comments.

[Copilot]

Pull request overview

Copilot reviewed 5 out of 5 changed files in this pull request and generated 3 comments.

[Copilot]

Pull request overview

Copilot reviewed 5 out of 5 changed files in this pull request and generated 3 comments.

[Copilot]

Pull request overview

Copilot reviewed 5 out of 5 changed files in this pull request and generated no new comments.

Comments suppressed due to low confidence (1)

crates/cargo-wdk/src/cli.rs:123

• The --target-platform help text is a bit ambiguous for a user discovering the flag via --help. Since this option directly selects the InfVerif validation mode (/u, /h, /w), consider stating that explicitly in the doc comment so the generated help output is self-explanatory.

    /// Driver target platform

[Copilot]

Pull request overview

Copilot reviewed 5 out of 5 changed files in this pull request and generated 1 comment.

Comments suppressed due to low confidence (1)

crates/cargo-wdk/src/cli.rs:123

• The --target-platform help text is a bit too terse and lacks a trailing period. Since this option directly controls which InfVerif mode flag is used, consider mentioning that in the doc comment so it shows up in --help output.

    /// Driver target platform

[Copilot]

Pull request overview

Copilot reviewed 6 out of 6 changed files in this pull request and generated no new comments.

Comments suppressed due to low confidence (1)

crates/cargo-wdk/src/actions/build/package_task.rs:35

• The comment mentions waiting for the InfVerif /samples flag, but the code currently passes /msft for sample-class validation. This makes the workaround description misleading; consider referencing both flag names (or the generic “sample-class flag”) so it matches the behavior in run_infverif() and future maintenance is clearer.

// FIXME: This range is inclusive of 25798. Update with range end after
// `/samples` flag is added to InfVerif CLI
const MISSING_SAMPLE_FLAG_WDK_BUILD_NUMBER_RANGE: RangeFrom<u32> = 25798..;

[Copilot]

Pull request overview

Copilot reviewed 6 out of 6 changed files in this pull request and generated no new comments.