61 lines
3.6 KiB
HTML
61 lines
3.6 KiB
HTML
<HTML>
|
|
<HEAD>
|
|
<META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=windows-1252">
|
|
<META NAME="Generator" CONTENT="Microsoft Word 97">
|
|
<TITLE>SERIAL</TITLE>
|
|
</HEAD>
|
|
<BODY TEXT="#000000" LINK="#0000ff" VLINK="#800080" BGCOLOR="#ffffff" leftmargin="8">
|
|
|
|
<FONT FACE="Verdana"><H2>SERIAL </H2>
|
|
|
|
<span style="color:#FF0000">[This is preliminary documentation and subject to change.]</span>
|
|
|
|
<H3>SUMMARY</H3>
|
|
</FONT><FONT FACE="Verdana" SIZE=2><P>This serial (16550-based RS-232) driver, which is compliant with Plug and Play, supports dynamic device enumeration (via serenum) and removal (either hotplug or via the device manager). The code serves as a sample for most serial-like devices. The behavior of the various routines is documented in the source code files.</P>
|
|
<P>The code works on Microsoft® Windows® 2000 or later platforms. This code will not work on previous versions Windows NT® due to issues with support for Plug and Play, Power Management, and the new class drivers.</P>
|
|
<P>The driver also supports Power Management;when the port is not opened, it is powered down and powered up on open. It supports wake-on-ring for platforms that support that function. The driver works on both x86 and Alpha platforms. </P>
|
|
</FONT><FONT FACE="Verdana"><H3>BUILDING THE SAMPLE</H3>
|
|
</FONT><FONT FACE="Verdana" SIZE=2><P>The files necessary to build the sample include those in the directory and Ntddser.h, stddef.h, and wmilib.h. Once built, the sample produces one binary: Serial.sys. Both checked and free builds are available. The necessary Inf file is msports.inf and is located in the %WINDIR%\inf directory.<P>
|
|
<B>NOTE:</B> Wmilib.sys must be present on the target machine for the binary to load properly. </P>
|
|
</FONT><FONT FACE="Verdana"><H3>RESOURCES</H3>
|
|
</FONT><FONT FACE="Verdana" SIZE=2><P>For the serial enumeration spec, read </FONT><A HREF="http://www.microsoft.com/hwdev/download/respec/pnpcom.rtf"><FONT FACE="Verdana" SIZE=2>http://www.microsoft.com/hwdev/download/respec/pnpcom.rtf</FONT></A><FONT FACE="Verdana" SIZE=2>. </P>
|
|
</FONT><FONT FACE="Verdana"><H3>CODE TOUR</H3>
|
|
<H4>File Manifest</H4>
|
|
</FONT><U><PRE>File			Description
|
|
</U>
|
|
Serial.htm		The documentation for this sample (this file).
|
|
Sources			The generic file for building this code sample.
|
|
Error.c			Error operations
|
|
Flush.c			Flush operations
|
|
Immediate.c 		Handles the sending of immediate data
|
|
Initunlo.c		Performs driver initialization and unload
|
|
Ioctl.c			IOCTL requests
|
|
Isr.c			Interrupt service routine functionality
|
|
Modmflow.c		Flow control functionality.
|
|
Openclos.c		CreateFile / Close functionality
|
|
Purge.c			Purge operations
|
|
Qsfile.c		Query/set file operations
|
|
Read.c			Read operations
|
|
Serial.rc		Resource data
|
|
Utils.c			Generic helper functionality
|
|
Waitmask.c		Wait/Mask functionality
|
|
Write.c			Write operations
|
|
Pnp.c			Plug-N-Play support
|
|
Registry.c		Misc. registry access functions
|
|
Legacy.c		Enumeration support for hand-entered devices
|
|
Wmi.c			WMI support
|
|
Power.c			Power support
|
|
Serlog.mc		Log messages
|
|
|
|
</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>
|
|
|
|
|