Source code of Windows XP (NT5)
You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
|
|
<HTML><HEAD><META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=windows-1252"><META NAME="Generator" CONTENT="Microsoft Word 97"><TITLE>Irclass</TITLE><META NAME="Template" CONTENT="C:\PROGRAM FILES\MICROSOFT OFFICE\OFFICE\html.dot"></HEAD><BODY TEXT="#000000" LINK="#0000ff" VLINK="#800080" BGCOLOR="#ffffff" leftmargin="8"><FONT FACE="Verdana"><H2><A NAME="MYSAMPLE">Infrared (Network) Class Coinstaller</A> </H2>
<h3>SUMMARY</h3></font><font FACE="Verdana" SIZE="2">This sample demonstrates the handling of DIF_ calls during device installation and theinsertion of a property page into the install wizard and into the device properties. </p>
<h3>BUILDING THE SAMPLE</h3></font><font FACE="Verdana" SIZE="2">
<p>To build Irclass.dll, select either the checked or free DDK environment, change to thedirectory Irclass, and type <B>BUILD</B>.</p>
<p>This sample is included as part of Windows® 2000 for installing and configuring serialinfrared devices. The corresponding .inf file, Netirsir.inf, can be found in the\WinNt\Inf directory after installation of the operating system.</p></font><font FACE="Verdana">
<h3>CODE TOUR</h3>
<h4>File Manifest</h4></font>
<pre><u><font face="Courier">Files Description</font></u><font face="Courier">Irclass.htm The documentation for this sample (this file)</font><u></u><fontFACE="Courier">Sources The generic file for building the code sampleIrclass.c The only source code for this sampleIrclass.h Header for Irclass.cIrclass.def DLL definition and exportsIrclass.rc Dialogs and string tablesIrexe.ico Icon for infrared devicesMakefile Standard makefileResource.h Microsoft Developer Studio generated include file</pre></font>
<h4><font face="Verdana">Programming Tour</font></h4><font face="Verdana" size="2">
<p>This code tour focuses on insertion of page into the install wizard.</p>
<p>The major topics covered in this tour include the following.
<ul> <li>Coinstaller</font><font FACE="Verdana" SIZE="2"></li> <li>Property Page Provider</font><font FACE="Verdana" SIZE="2"></li></ul>
<h4><font face="Verdana" size="2">Coinstaller</h4></font>
<p><font face="Verdana" size="2">Coinstallers are meant to handle special cases ofinstallation of which a generic class installer may not be aware. Infrared devicesare essentially network devices, and so the majority of the installation is handled by thenetwork class installer. There are details about an infrared device of which thenetwork class installer is unaware, such as the selection of the serial port the device isattached to, and the coinstaller mechanism is provided to extend the functionality of amore generic class installer in these situations.</font></p>
<p><font face="Verdana" size="2">A coinstaller is very similar to a regular classinstaller. It receives each DIF_* call before the regular class installer does, butit only needs to provide handlers for those DIF_* calls where it desires to modify orextend the behavior or the regular class installer. In this sample,IrSIRClassCoinstaller is the main coinstaller function, and it only handles two calls,DIF_INSTALLDEVICE and DIF_NEWDEVICEWIZARD_FINISHINSTALL.</font></p>
<p><font face="Verdana" size="2">DIF_INSTALLDEVICE is handled by the coinstaller to allowit to check and modify the UPPERFILTER and LOWERFILTER values for the Irsir.sys driver. Irsir.sys may use Serial.sys as a lower filter, and it sets this value here. It reads the LowerFilters entry from Netirsir.inf, and writes this value to theregistry. It also clears the UPPERFILTER value because Serial.sys may useSerenum.sys as an upper filter, which is inappropriate for Irsir.sys. DIF_INSTALLDEVICE is the most convenient place to do this because at this point thedriver has not yet been loaded.</font></p>
<p><font face="Verdana" size="2">DIF_NEWDEVICEWIZARD_FINISHINSTALL is the coinstaller'sbest opportunity to prompt for special parameters for the driver. The driver mayhave already been started at this point, so you should ensure that your driver does notcrash if any parameter is not set yet. This function allows us to insert a finalpage into the wizard to query the user. The PortSelectionDlg function handlesinserting the page, which will subsequently be invoked by the install mechanism.</font></p>
<h4><font face="Verdana" size="2">Property Page Provider</font></h4>
<p><font face="Verdana" size="2">You should note that the Property Page Provider and theWizard page share a common message handling function, PortDlgProc. Minor differencesare handled by the FirstTimeInstall flag which is set to TRUE in the wizard pageinitialization code, and FALSE otherwise. At the dialog completion, it callsWriteRegistrySettings, which sets the flag </font>DI_FLAGSEX_PROPCHANGE_PENDING. This is the cue to the OS that a driver's settings have changed, and the driverneeds to either reload them or be restarted depending on its capabilities.</p>
</FONT><P ALIGN="CENTER"><A HREF="#top"><FONT FACE="Verdana" SIZE=2>Top of page</FONT></A><FONT FACE="Verdana" SIZE=2> </P></FONT><TABLE CELLSPACING=0 BORDER=0 WIDTH=624><TR><TD VALIGN="MIDDLE" BGCOLOR="#00ffff" HEIGHT=2><P></TD></TR></TABLE>
<FONT FACE="MS Sans Serif" SIZE=1><P>© 1999 Microsoft Corporation</FONT><FONT FACE="Verdana" SIZE=2> </P></FONT></BODY></HTML>
|
