diff options
| author | Barry Golden <[email protected]> | 2015-08-05 18:05:49 -0700 |
|---|---|---|
| committer | Barry Golden <[email protected]> | 2015-08-05 18:05:49 -0700 |
| commit | 36bf4df42a182a6b6d3e707099f985fe8a644001 (patch) | |
| tree | db99a24955a528a7b822df98aa6dcdcbce70a9bd /biometrics | |
| parent | c7e42e0b72ed24fb3d9bb1da085ea67a68e99554 (diff) | |
Remove obsolete readme.htm
Diffstat (limited to 'biometrics')
| -rw-r--r-- | biometrics/driver/readme.htm | 166 |
1 files changed, 0 insertions, 166 deletions
diff --git a/biometrics/driver/readme.htm b/biometrics/driver/readme.htm deleted file mode 100644 index fdd2bd00..00000000 --- a/biometrics/driver/readme.htm +++ /dev/null @@ -1,166 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 3.2 Final//EN"><HTML DIR="LTR" xmlns:MSHelp="http://msdn.microsoft.com/MSHelp"> -<HEAD> -<META http-equiv="Content-Type" content="text/html; charset=iso-8859-1"> -<TITLE>Windows Biometric Driver Interface (WBDI) Sample</TITLE> -<META NAME="ms.locale" content="en-us"> -<META NAME="DESCRIPTION" CONTENT="Biometric_s, Samples, Design Guide, Windows Biometric Driver Interface (WBDI) Sample"><xml><MSHelp:Attr Name="WdkCategory" Value="WdkBio"/> -<MSHelp:Attr Name="WdkCategory" Value="WdkSample"/> -<MSHelp:Attr name="CommunityContent" value="1"/> -<MSHelp:Attr name="EnableMachineTranslation" value="1"/> -<MSHelp:Keyword Index="A" Term="BiometricSamples_1ede4079-1f99-4d1f-b3ae-aef6efe61c64.xml"/></xml><LINK REL="stylesheet" type="text/css" HREF="backsdk4.css"><SCRIPT SRC="langref.js"></SCRIPT><style>dd {margin-bottom:0em; margin-left:1.9em; }</style> -<style>.divclass {behavior:url(#default#savehistory);}</style> -<META NAME="save" CONTENT="history"> -<LINK REL="stylesheet" TYPE="text/css" HREF="ms-help://Hx/HxRuntime/HxLink.css"> -<LINK REL="stylesheet" TYPE="text/css" HREF="ms-help://Hx/HxRuntime/HxLinkDefault.css"> -</HEAD> -<Body topmargin="0"> -<DIV STYLE="display:none;"></DIV> -<TABLE CLASS="buttonbarshade" CELLSPACING="0" border="0"><TR><TD NOWRAP="true">�</TD></TR></TABLE> -<TABLE CLASS="buttonbartable" CELLSPACING="0"> -<TR ID="hdr"> -<TD NOWRAP="true" CLASS="runninghead">Windows Driver Kit: Biometric Devices</TD> -</TR> -</TABLE> -<H1><A NAME="BiometricSamples_1ede4079-1f99-4d1f-b3ae-aef6efe61c64.xml"></A>Windows Biometric Driver Interface (WBDI) Sample</H1><span style="color:#FF0000">[This is preliminary documentation and subject to change.]<BR><BR></span><H4>Description</H4> -<P>�This sample implements the Windows Biometric Driver Interface (WBDI). It contains shell code for handling the mandatory IOCTLs necessary to interoperate with the Windows Biometric Framework. A WBDI driver can be deployed in conjunction with an engine adapter DLL to allow a sensor to be exposed from the Windows Biometric Framework. This sample has been written to make use of the UMDF framework, which allows for ease of development and system stability.</P> -<H4>Theory of Operation</H4> -<P>�This sample was taken from the UMDF FX2 sample and modified to expose WBDI. It will install on top of the OSR FX2 test device. It still has basic USB operations for talking to a USB device, but it also has the necessary hooks to make this a WBDI driver:</P> -<P>Installs WBDI driver, including correct class GUID settings and icons, and registry settings for Windows Biometric Framework configuration</P> -<P>Publishes WBDI device interface</P> -<P>Supports all the mandatory WBDI IOCTLs</P> -<P>Supports cancellation</P> -<P>Can be opened with exclusivity</P> -<P>All of these things are required for the Windows Biometric Framework service to recognize this device as a biometric device and set up a Biometric Unit. It allows the service to properly control the device.</P> -<H4>Implementation and Design</H4> -<P>The sample makes use of ATL support for simplified handling of COM objects with UMDF.�</P> -<P>The driver makes use of a parallel queue so that multiple requests can be outstanding at once. </P> -<P>It uses device level-locking to simplify internal thread synchronization. This means that only one framework callback can be active at a time.</P> -<P>It supports cancellation of any IOCTL which may be I/O intensive, particularly a capture IOCTL. This sample does not have a real capture mechanism, so it is simulated by a 5 second delay returning a capture IOCTL. Cancellation is supported through the mechanism exposed by WUDF, with a callback for a request object. Cancellation support is required for all IOCTLs.</P> -<P>There are hooks for all WBDI IOCTLs, including the optional IOCTLs.</P> -<P>PnP is very simple for this driver. It needs to only implement OnPrepareHardware and OnReleaseHardware from IPnpCallbackHardware.</P> -<P>Some device drivers may need to keep several pending reads to the WinUsb I/O target in order to properly flush all I/O that comes from the device during a capture.</P> -<H4>Software Requirements</H4> -<P>The sample runs on the following Windows operating systems: </P><B></B><UL type="disc"> -<LI>Windows�7</LI> -<P></P> -</UL> -<H4>Hardware Requirements </H4> -<P>The sample requires the following hardware: </P><B></B><UL type="disc"> -<LI>OSR FX2 test device</LI> -<P></P> -</UL> -<P></P> -<H4>Processor Requirements </H4> -<P>The sample runs on the following processor architectures: </P><B></B><UL type="disc"> -<LI>x86</LI> -<LI>x64</LI> -<LI>IA64</LI> -<P></P> -</UL> -<P></P> -<H4>Installation</H4> -<P>�The following files must be present in order to install this driver:</P> -<P>WudfBioUsbSample.dll</P> -<P>WudfBioUsbSample.inf</P> -<P>EngineAdapter.dll (built from adapter sample)</P> -<P>This sample installs on the OSR FX2 test device. It will not capture real data, but it will create a Biometric Unit in the Windows Biometric Framework.</P> -<P>TBD – Links to the test driver suite should go here.</P> -<H4>Code Tour</H4> -<P><b>File Manifest</b></P><B></B><table> -<TR valign="top"> -<TH Width="" style="background-color:#CCCCCC;">File</TH> -<TH Width="" style="background-color:#CCCCCC;">Description</TH> -</TR> -<TR valign="top"> -<TD Width="" style="background-color:#FFFFFF;">BioUsbSample.ctl</TD> -<TD Width="" style="background-color:#FFFFFF;">Contains the trace guid for the driver</TD> -</TR> -<TR valign="top"> -<TD Width="" style="background-color:#FFFFFF;">BioUsbSample.rc</TD> -<TD Width="" style="background-color:#FFFFFF;">File name and description resources</TD> -</TR> -<TR valign="top"> -<TD Width="" style="background-color:#FFFFFF;">Device.cpp</TD> -<TD Width="" style="background-color:#FFFFFF;">Implements the CBiometricDevice class, which has methods to interface with the WinUsb I/O target and methods that implement the WBDI IOCTLs</TD> -</TR> -<TR valign="top"> -<TD Width="" style="background-color:#FFFFFF;">Device.h</TD> -<TD Width="" style="background-color:#FFFFFF;">Contains type definitions for the device, including CBiometricDevice class</TD> -</TR> -<TR valign="top"> -<TD Width="" style="background-color:#FFFFFF;">dllsup.cpp</TD> -<TD Width="" style="background-color:#FFFFFF;">Implements the driver DLL entry points</TD> -</TR> -<TR valign="top"> -<TD Width="" style="background-color:#FFFFFF;">Driver.cpp</TD> -<TD Width="" style="background-color:#FFFFFF;">Implements the CBiometricDriver class</TD> -</TR> -<TR valign="top"> -<TD Width="" style="background-color:#FFFFFF;">Driver.h</TD> -<TD Width="" style="background-color:#FFFFFF;">Defines CBiometricDriver class</TD> -</TR> -<TR valign="top"> -<TD Width="" style="background-color:#FFFFFF;">exports.def</TD> -<TD Width="" style="background-color:#FFFFFF;">Defines DLL exports</TD> -</TR> -<TR valign="top"> -<TD Width="" style="background-color:#FFFFFF;">internal.h</TD> -<TD Width="" style="background-color:#FFFFFF;">Pre-compiled header containing all common headers and type definitions</TD> -</TR> -<TR valign="top"> -<TD Width="" style="background-color:#FFFFFF;">IoQueue.cpp</TD> -<TD Width="" style="background-color:#FFFFFF;">Implements CBiometricIoQueue, a parallel queue for processing IOCTLs</TD> -</TR> -<TR valign="top"> -<TD Width="" style="background-color:#FFFFFF;">IoQueue.h</TD> -<TD Width="" style="background-color:#FFFFFF;">Defines CBiometricIoQueue</TD> -</TR> -<TR valign="top"> -<TD Width="" style="background-color:#FFFFFF;">Makefile</TD> -<TD Width="" style="background-color:#FFFFFF;">Build file</TD> -</TR> -<TR valign="top"> -<TD Width="" style="background-color:#FFFFFF;">makefile.inc</TD> -<TD Width="" style="background-color:#FFFFFF;">Build file</TD> -</TR> -<TR valign="top"> -<TD Width="" style="background-color:#FFFFFF;">RequestHelper.h</TD> -<TD Width="" style="background-color:#FFFFFF;">Defines and implements a helper class that ensures a request is completed correctly upon exit</TD> -</TR> -<TR valign="top"> -<TD Width="" style="background-color:#FFFFFF;">resource.h</TD> -<TD Width="" style="background-color:#FFFFFF;">Resource definitions</TD> -</TR> -<TR valign="top"> -<TD Width="" style="background-color:#FFFFFF;">Sources</TD> -<TD Width="" style="background-color:#FFFFFF;"></TD> -</TR> -<TR valign="top"> -<TD Width="" style="background-color:#FFFFFF;">WudfBioUsbSample.inx</TD> -<TD Width="" style="background-color:#FFFFFF;">Unprocessed INF file, which is generated at build time</TD> -</TR> -<TR valign="top"> -<TD Width="" style="background-color:#FFFFFF;">inc\list.h</TD> -<TD Width="" style="background-color:#FFFFFF;">Implements a doubly linked list</TD> -</TR> -<TR valign="top"> -<TD Width="" style="background-color:#FFFFFF;">inc\public.h</TD> -<TD Width="" style="background-color:#FFFFFF;">Definitions for OSR_FX2 device operations.</TD> -</TR> -<TR valign="top"> -<TD Width="" style="background-color:#FFFFFF;">inc\usb_hw.h</TD> -<TD Width="" style="background-color:#FFFFFF;">Defines prototypes for interfacing with a USB connected device</TD> -</TR> -<TR valign="top"> -<TD Width="" style="background-color:#FFFFFF;">WUDFOsrUsbPublic.h</TD> -<TD Width="" style="background-color:#FFFFFF;">Defines the public interface GUID for the OSR_FX2 device</TD> -</TR> -</table> -<P></P> -<P></P> -<P></P> -<DIV CLASS="footer"><br><A HREF="DDKLegal.htm">��2008�Microsoft Corporation</A><br><A HREF="mailto:[email protected]?subject=WDK Topic Feedback&body=Build date: November 17, 2008 Help file: Biometric_s - Topic title: Windows Biometric Driver Interface (WBDI) Sample">Send feedback on this topic</A><br>Built on�November 17, 2008<br></DIV> -<DIV style="visibility:hidden">Build machine: CAPEBUILD</DIV> -</Body> -</HTML> |