windows-nt/Source/XPSP1/NT/net/unimodem/readme.htm
2020-09-26 16:20:57 +08:00

66 lines
6.1 KiB
HTML

<HTML>
<HEAD>
<META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=windows-1252">
<META NAME="Generator" CONTENT="Microsoft Word 97">
<TITLE>UM5 External Drop: Roadmap</TITLE>
<META NAME="Version" CONTENT="8.0.3410">
<META NAME="Date" CONTENT="10/11/96">
<META NAME="Template" CONTENT="C:\Program Files\Microsoft Office\Office\HTML.DOT">
</HEAD>
<BODY TEXT="#000000" LINK="#0000ff" VLINK="#800080" BGCOLOR="#ffffff">
<FONT SIZE=5><P ALIGN="CENTER">Roadmap of the Unimodem Source Code </P>
</FONT><P>&nbsp;</P>
<B><P>Owner: JosephJ</P>
<P>Last Modified: 5/30/1997</P>
<FONT FACE="Arial,Arial" SIZE=4><P>Contents</P>
</B></FONT><P><A HREF="#documentation">Documentation</A> -- Pointers to documentation included in this drop.</P>
<P><A HREF="#sources">Sources</A> -- Brief description of the source code directories included in this drop.</P>
<P ALIGN="CENTER"><A NAME="Documentation"></P>
<P><HR></P>
<B><FONT FACE="Arial,Arial" SIZE=4><P>Documentation</A></P>
</B></FONT><FONT FACE="Arial,Arial"><P>Documentation files are under .\doc. They are a collection of word docs and html files.</P>
</FONT><P><A HREF="docs/html/design/um5_dov.doc"><B><FONT FACE="Arial,Arial">Architecture Overview</B></FONT></A><FONT FACE="Arial,Arial"> (.\docs\html\design\um5_dov.doc) - overview of unimodem 5.0 design, with pointers to more detailed information. <B><I>Read this before any of the following documentation</B></I>. <B>WARNING:</B> This document has not been updated recently. In particular, the architecture has changed so that there is no longer an explicit set of "media handler" which communicate to the media-specific drivers. Instead, the serial wave driver call into IOCTLs exposed by modem.sys to start/stop play/record. Furthermore, the extensibility architecture has changed -- instead of a separate extensibility dll, the extensibility dll is in the form of a layered user-mode minidriver -- visualize this as a box above in-between the TSP and the user-mode mini-drivers. Furthermore, it was designed for internal use and has many links that are not enabled in this external drop. Nevertheless, it remains a very useful overview.</P>
</FONT><P><A HREF="docs/html/design/tsp5imp.doc"><B><FONT FACE="Arial,Arial">TSP Implementation</B></FONT></A><FONT FACE="Arial,Arial"> (.\docs\html\design\tsp5imp.doc)-- Implementation notes for the TSP. <B>This includes a proposed specification for extending the TSP. </B>Since documentation for the interfaces is relatively sketchy, <B>this is a very useful document</B> to help someone read the TSP code and understand the implementation. This document also identifies the key source files in the TSP.</P>
</FONT><P><A HREF="docs/html/design/um5mdd.doc"><B><FONT FACE="Arial,Arial">Mini Driver</B></FONT></A><FONT FACE="Arial,Arial"> (.\docs\html\design\um5mdd.doc) -- The specification and design of the user-mode unimodem minidriver and modem-specific kernel-mode components. <B>WARNING:</B> This document has not been updated recently. However it is still relevant.</P>
</FONT><P><A HREF="docs/html/design/nt5pnp.doc"><B><FONT FACE="Arial,Arial">PnP Design</B></FONT></A><FONT FACE="Arial,Arial"> (.\docs\html\design\nt5pnp.doc) A brief note on the changes required to support PnP on Unimodem for NT5.0.</P>
</FONT><P>&nbsp;</P>
<P><HR></P>
<B><FONT FACE="Arial,Arial" SIZE=4><P><A NAME="Sources">Sources</A></P>
</B></FONT><P>Following are a listing of the key sub-directories and the components they build.</P>
<B><I><FONT FACE="Arial,Arial"><P>.\private\ntos\dd\modem</P>
</B></I></FONT><P>Modem.sys, the unimodem kernel-mode component.</P>
<B><I><FONT FACE="Arial,Arial"><P>.\public\sdk\inc</P>
</B></I></FONT><P>Only ntddmodm.h, which contains definitions of IOCTLS used to control modem.sys.</P>
<B><I><FONT FACE="Arial,Arial"><P>.\private\unimodem\inc</P>
</B></I></FONT><P>Some common unimodem private internal header files. The most important one is umdmmini.h, which is the UM5 minidriver header file.</P>
<B><I><FONT FACE="Arial,Arial"><P>.\private\unimodem\src</P>
</B></I></FONT><P>Mmost user-mode unimodem code lives here.</P>
<B><I><FONT FACE="Arial,Arial"><P>.\private\unimodem\src\inc</P>
</B></I></FONT><P>Common private headers specific to new code for UM5.</P>
<B><I><FONT FACE="Arial,Arial"><P>.\private\unimodem\src\tsp</P>
</B></I></FONT><P>Builds UNIMDM.TSP, the dll that exports the TSPI APIS. Note: the document <A HREF="docs/html/design/tsp5imp.doc">.\docs\design\tsp5imp.doc</A> describes the implementation and points to the key source files.</P>
<B><I><FONT FACE="Arial,Arial"><P>.\private\unimodem\src\atmini</P>
</B></I></FONT><P>Builds UNIMDMAT.DLL, the AT-Minidriver. Note: the document <A HREF="docs/design/um5mdd.doc">.\docs\design\um5mdd.doc</A> describes the design of the AT-Minidriver.</P>
<B><I><FONT FACE="Arial,Arial"><P>.\private\unimodem\src\nt5plat</P>
</B></I></FONT><P>Builds UNIPLAT.DLL for NT, which provides wrappers around platform-specific entrypoints.</P>
<B><I><FONT FACE="Arial,Arial"><P>.\private\unimodem\src\win95plat</P>
</B></I></FONT><P>Builds UNIPLAT.DLL for Win95 (not functional at present).</P>
<B><I><FONT FACE="Arial,Arial"><P>.\private\unimodem\src\serwvdrv</P>
</B></I></FONT><P>Builds SERWVDRV.DLL, the Unimodem Serial Wave Driver for Class-8 modems.</P>
<B><I><FONT FACE="Arial,Arial"><P>.\private\unimodem\src\umdmxfrm</P>
</B></I></FONT><P>Builds UMDMXFRM.DLL, the Unimodem Serial Wave Driver for Class-8 modems.</P>
<B><I><FONT FACE="Arial,Arial"><P>.\private\unimodem\src\testmini</P>
</B></I></FONT><P>Builds ATMODEM.EXE, a test application that tests the unimodem minidriver directly.</P>
<B><I><FONT FACE="Arial,Arial"><P>.\private\unimodem\src\stress\mdmmini</P>
</B></I></FONT><P>Builds MDMMINI.EXE, stress test of the minidriver.</P>
<B><I><FONT FACE="Arial,Arial"><P>.\private\unimodem\src\stress\mdmtapi</P>
</B></I></FONT><P>Builds MDMTAPI.EXE, system stress test for unimodem datamodem connections (this is a TAPI app).</P>
<B><I><FONT FACE="Arial,Arial"><P>.\private\unimodem\src\stress\vmdmtest</P>
</B></I></FONT><P>Builds VMDMTEXT.EXE, a app that can dial and answer AUTOMATEDVOICE calls (this is a TAPI app).</P>
<P>&nbsp;</P>
<P>&nbsp;</P>
<P>&nbsp;</P>
<P>&nbsp;</P></BODY>
</HTML>