Delivering Great Device Installation Experiences

2. 888 Delivering Great Device Installation Experiences Adam Lenart Software Design Engineer Microsoft Corporation Cameron Brodeur Program Manager Microsoft Corporation

3. Agenda • What makes a device installation great? • Device Installation & Device Configuration • How to take advantage of Device Configuration • Installing apps with a device • Demo: Diagnosing device installation problems • Q&A You’ll leave with examples of how to • Improve the performance of device installation • Diagnose common installation problems

4. Related sessions • Designing great devices and drivers (HW-322T) • Building metro style apps that connect to specialized devices (HW-747T) • Best practices for packaging and distributing device drivers (HW-903T) • Simplifying wireless and network device discovery and pairing (HW-286T)

5. What Makes a Device Installation Great? • Great device experiences are designed • Device setup is fast • Device apps are Metro style apps

6. Relative Device Installation Performance Install time (lower is better) radical performance improvement

7. Driver Store Offline Image Creation Windows “Inbox” Driver Store OS Setup & Upgrade Windows Update Software Installers SetupCopyOEMInf Factory Unattended Setup

8. Device Installation Class/Co-installers Driver Store 1 2 3

9. Device Configuration Driver Store 1 2 3

10. Device Configuration Input Storage Boot Devices Other select devices

11. Making your device configurable • Windows Certification tests • Passing the recommended certification tests ensures configurability • Windows 8 Certification Requirements - Preview

12. Things to watch out for • Using a Co-Installer or custom Class Installer • Referencing INF directives not related to installation • Deleting or modifying registry entries, files or services • Only specify HKRwhen using AddRegdirective • Only copy files to • %WINDIR%\System32 • %WINDIR%\System32\Drivers • Specify PnpLockdown=1in the [Version] section

13. …and a couple more • Only install driver services • Target OS version decoration in an INF file cannot contain a ProductTypeflag or SuiteMaskflag

14. Configurable Driver Package INF • [Version] • ... • DriverVer = 09/16/2011,1.0.0.3 ; Update date/version with every change • CatalogFile = driver.cat ; Always sign driver package INF and files • PnpLockdown = 1 ; Protect driver files from tampering • [Manufacturer] • %Mfg.Desc% = Drivers,NTx86; Explicitly target platform/architecture • [Drivers.NTx86] • %Device.Desc% = Device_Install,USB\VID_ABCD&PID_1234 • [Device_Install.NT] • ... • [Device_Install.NT.Services] • ...

15. Configurable Driver Package INF- Files • [Device_Install.NT] • CopyFiles = Driver_CopyFiles • ... • [Driver_CopyFiles] • driver.sys ; Keep it simple, no special copying rules • [SourceDisksNames] • 1 = %Disk.Desc% • [SourceDisksFiles] • driver.sys = 1 • [DestinationDirs] • DefaultDestDir = 12 ; %WINDIR%\System32\Drivers

16. Configurable Driver Package INF - Settings • [Device_Install.NT] • ... • AddReg = Driver_AddReg • [Driver_AddReg] • HKR,,Setting,%REG_SZ%,"Value"; Only specify HKR-based driver software values • ... • [Device_Install.NT.Hw] • AddReg = Device_AddReg • ... • [Device_AddReg] • HKR,,Bells,%REG_DWORD%,1 ; Only specify HKR-based device hardware values • HKR,,Whistles,%REG_DWORD%,256 • ...

17. Configurable Driver Package INF - Services • [Device_Install.NT.Services] • AddService = driver,%SPSVCINST_ASSOCSERVICE%,Service_Install; Always associate one service • [Service_Install] • ServiceType = %SERVICE_KERNEL_DRIVER% ; Only add kernel driver services • StartType = %SERVICE_SYSTEM_START% • ErrorControl = %SERVICE_ERROR_NORMAL% • ServiceBinary = %12%\driver.sys • DisplayName = %Driver.Desc% • AddReg = Service_AddReg • [Service_AddReg] • HKR,,Mode,%REG_DWORD%,2 ; Only specify HKR-based service values • ...

18. Configurable Driver Package INF - WDF • [Device_Install.NT.Wdf] • KmdfService= driver,KmdfService_Install; KMDF-based driver • UmdfService= UmdfDriver,UmdfService_Install; UMDF-based driver • UmdfServiceOrder = UmdfDriver • [KmdfService_Install] • KmdfLibraryVersion= 1.0 • [UmdfService_Install] • UmdfLibraryVersion = 1.9.0 • DriverCLSID = {XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX} • ServiceBinary = %12%\UMDF\UmdfDriver.dll • [Device_Install.NT.Services] • AddService = WUDFRd,0x000001fa,WUDFRD_Install; WUDFRd service for UMDF driver • ...

19. Delivering the App Experience • The best device experiences use a Metro style app • Automatic download and setup • Built-in app experiences for common device classes • Printers, webcam, mobile broadband SIM • Support for custom apps • WPD, Storage, Networking • Custom drivers with custom interfaces

20. Delivering the App Experience Metro style app for Devices Automatic download and setup of Metro style apps for devices Driver Faster download of simpler driver package Driver Package

21. Installing Desktop Software With a Device • Recommend use of RequestAdditionalSoftware INF directive • Allows a device to indicate that software may be available • Driver package download is fast • Provides you with flexibility • Software can be updated at anytime without the need to update the driver package • Decouples the driver from the software • User decides if they need a Desktop app experience

22. Request Additional Software • Simple INF directive: RequestAdditionalSoftware • [ControlFlags] • RequestAdditionalSoftware=* • applies to all devices installed by the driver package, or … • [ControlFlags] • RequestAdditionalSoftware=device-identification-string[,device-identification-string] ... • only to specific devices. • Available on Windows 7 and later.

23. demo Diagnosing device problems

24. Q&A

25. Related sessions • Device and Driver Installation • Windows Hardware Dev Center • Windows Dev Center

26. Further reading and documentation Device Configuration and Windows Certification • Windows 8 Certification Requirements – Preview • Device and Driver Installation (MSDN) Apps for hardware • Metro style Device App for Specialized Devices - Design Guide • The Device Software Lifecycle – Deployment, Acquisition, Uninstall and Update Process • Metro style Device App for Specialized Devices Custom Driver Access Design Guide • Metro style Device App for Specialized Devices Custom Driver Access Development Guide • RequestAdditionalSoftware INF [ControlFlags] directive

27. © 2011 Microsoft Corporation. All rights reserved. Microsoft, Windows, Windows Vista and other product names are or may be registered trademarks and/or trademarks in the U.S. and/or other countries. The information herein is for informational purposes only and represents the current view of Microsoft Corporation as of the date of this presentation. Because Microsoft must respond to changing market conditions, it should not be interpreted to be a commitment on the part of Microsoft, and Microsoft cannot guarantee the accuracy of any information provided after the date of this presentation. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS PRESENTATION.

28. Backup Slides

29. Driver Ranking 0000-0FFF: 1000-1FFF: 2000-2FFF: 3000-3FFF: Hardware Hardware Hardware Compatible CompatibleHardware Compatible Compatible Signer Score 00 FF 0002 Device Driver Feature Score