mirror of
https://github.com/KastnerRG/riffa.git
synced 2025-01-30 23:02:54 +08:00
To build the Windows driver: 1) Install Windows Driver Development Kit supporting Windows 7 (tested on version 7600.16385.1). 2) Open a DDK command window environment for Windows 7 (which ever version you're targeting). 3) Move to the directory containing this README.txt and run: build -ceZ 4) The driver should be built and ready in the output directory along with a Windows 7 catalog file and the coinstaller DLLs. A few notes: - You will need to sign the driver (riffa.sys) and catalog file (riffa.cat) before you can install it on a x64 Windows 7 or Vista computer. The build process will attempt to sign the catalog file with the UCSD certificate. You don't have that, so you won't get a signed driver simply by building. You'll need to get a certificate from a certificate authority that is capable of cross-certificate kernel driver signing. See this page for more details: http://msdn.microsoft.com/en-us/windows/hardware/gg487315.aspx - Debugging on Windows is difficult because there exists no kernel log file. Drivers are supposed to log messages using a trace events framework which is overly complex and requires developer tools to first collect the output and then more (different) tools to make the output human readable. Instead, this driver writes normal log messages via a kernel debugger facility. To see the messages you'll need the Windows Development Kit debugger (WinDbg) or a small utility called DbgView. DbgView is a standalone kernel debug viewer that can be downloaded from Microsoft here: http://technet.microsoft.com/en-us/sysinternals/bb896647.aspx Just start with administrator privileges and be sure to enable Capture Kernel, Capture Events, and Capture Verbose Kernel Output. - Building with the checked environment will produce a version of the driver with verbose debugging output. Building with the free environment will produce a version of the driver with minimal messaging output. The debug version will have a "(Debug)" label in the Windows device manager, so you can tell which version is installed. - Inno Setup scripts produce a Windows Installer. You may use our script if you like.