microsoft/windows-drivers-rs

Add `WDF_STRUCTURE_SIZE` macro equivalent

Open

#242 opened on Nov 7, 2024

View on GitHubContributor guide
 (3 comments) (0 reactions) (0 assignees)Rust (128 forks)auto 404
enhancementgood first issue

Repository metrics

Stars
 (1,886 stars)
PR merge metrics
 (PR metrics pending)

Description

WDF_STRUCTURE_SIZE is a macro available in the WDK, but isn't available in wdk-sys since bindgen can't generate macros. WDF_STRUCTURE_SIZE is useful since many of the _INIT macros are also not available right now. A 1:1 implementation of WDF_STRUCTURE_SIZE should be made available in wdk-sys, although an equivalent shouldn't be needed in wdk given that the safe abstractions shouldn't need to do any of the c-style manual initializations.

Contributor guide

Research direction
Implement a Rust macro that calculates the size of a WDF structure using the `size of` and `offset of` macros, matching the behavior of the C `WDF STRUCTURE SIZE` macro.
Tech stack
rust
Domain
developer experiencetooling
Issue type
Feature
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
2
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
1-3 hours
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
Active
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
Clear
Prerequisites
RustWindows Driver Kit
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
50