WBF wrapper specifications

These statements describe current implementation at hisd/customer/6_01_mainbranch_20260506 / 10b4330a37b333092634f63dc02c24ceb41d61f7. They are not approved product requirements.

WBDI driver

Owns CBiometricDriver/CBiometricDevice, WDF requests, capture threads, power/wake handling and USB/SPI/HID transports. Primary evidence: wbdi/driver/.

WBF adapters

Implements sensor, engine and storage adapter callbacks plus generic adapter state. Primary evidence: adapters/synaFpAdapter/.

niseCore bridge

Maps Windows driver operations to the VFM/niseCore API. Primary evidence: wbdi/driver/vfmCoreEntry.*.

Capture pipeline

Coordinates asynchronous capture, cancellation, completion and notify-wake. Primary evidence: wbdi/driver/CaptureImage.* and BiometricDevice.*.

Customer projects

Defines per-customer properties, matcher/options, package and feature selection. Primary evidence: CustomerProjects/.

Services

Provides policy/reset/monitoring/analysis and CTAP-related services where selected. Primary evidence: services/.

Installer/package

Builds driver/service packages and install-time components. Primary evidence: wbdi/package/, services/package/, coInstallers/.

Optional UI/utilities

Supplies customer-selected applications, RPC/UWP service and diagnostics. Primary evidence: applications/, SynUwpService/, SynaSmi/, utilities/.

Invariants

• Preserve interface/ABI compatibility unless all consumers move together.
• Keep customer/ref and test variant context explicit.
• Report absent evidence as a gap rather than assuming success or deployment.