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.

96 lines
5.7 KiB

  1. <HTML>
  2. <HEAD>
  3. <META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=windows-1252">
  4. <META NAME="Generator" CONTENT="Microsoft Word 97">
  5. <TITLE>BDA Tuner Driver</TITLE>
  6. <META NAME="Template" CONTENT="C:\PROGRAM FILES\MICROSOFT OFFICE\OFFICE\html.dot">
  7. </head><body topmargin="0">
  8. <FONT FACE="Verdana"><H2><A NAME="MYSAMPLE">BDA Tuner Driver</A> </H2>
  9. <P><span style="color:#FF0000;font-size:10pt;font-family:Arial">[This is preliminary documentation and subject to change.]</span></P>
  10. <H3>SUMMARY</H3></FONT><FONT FACE="Verdana" SIZE=2><P>
  11. This sample is the source code for a Broadcast Driver Architecture (BDA) tuner driver<!-- for Windows&#174; 2000-->. It is provided as an example of a BDA device minidriver for the AVStream class of kernel streaming. Use the BDA tuner driver with a Philips tuner card.<P>
  12. <H3>BUILDING THE SAMPLE</H3></FONT><FONT FACE="Verdana" SIZE=2><P>
  13. To build the sample, open a DDK command window, change to the BDA directory, and use the <B>build</B> command. Before you can use the sample, you need to install the Philips tuner card.
  14. <P>
  15. To install the tuner card, shut down the computer, insert the tuner card, and boot. The operating system uses the PhilTune.inf file to detect and install the tuner card.<P>
  16. After the tuner card is installed, the built sample, Philtune.sys, is in the %SystemRoot%\System32\Drivers directory of the operating system.<P>
  17. <!--Plug and Play and Power Management are not implemented in Philtune.sys. <P> -->
  18. Building this sample produces one file: Philtune.sys. Both free and checked versions are buildable.<P>
  19. <H3>TOOLS</H3></FONT><FONT FACE="Verdana" SIZE=2><P>
  20. The BDA network provider filter uses the BDA tuner driver to configure a filter in a filter graph. This filter is used to tune and demodulate a digital signal. Other filters in the filter graph capture video frames and present the video on the display.<P>
  21. <H3>RESOURCES</H3></FONT><FONT FACE="Verdana" SIZE=2><P>
  22. To get a logo for your device, consult the <A HREF="http://www.microsoft.com/hwtest">WHQL Web site</a> for information and test suites.<P>
  23. Your device should support Plug and Play. Download Plug and Play specs from their <A HREF="http://www.microsoft.com/hwdev/respec/pnpspecs.htm">Web site</A>.<P>
  24. <H3>CODE TOUR</H3>
  25. <H4>File Manifest</H4>
  26. </FONT><U><PRE>File&#9;&#9; Description
  27. </U>
  28. Antenna.cpp&#9; Implements the class for the input Antenna pin
  29. Ari.cpp&#9; Implements the ARI-chip properties of the device class
  30. Bdadebug.h&#9; Contains macros that the driver uses for debugging
  31. Bdaguid.c&#9; Includes header files used for defining GUIDs
  32. Bdatune.htm&#9; The documentation for this sample (this file)
  33. Common.h&#9; Includes necessary header files, like Bdasup.h
  34. DevCaps.cpp&#9; Contains data specific to hardware
  35. Device.cpp&#9; Main code of BDA device, including driver-entry point
  36. Filter.cpp&#9; Implements methods of the filter class
  37. FiltProp.cpp&#9; Implements properties of the filter class
  38. Gpio.cpp&#9; Implements the GPIO class
  39. Gpio.h&#9; Defines GPIO class
  40. I2Script.cpp&#9; Implements the class for the Inter-IC (I2C) bus that is used
  41. to connect integrated circuits (ICs) on the card
  42. I2Script.h&#9; Defines structure for the I2C bus
  43. Ksvsb.h&#9; Defines constants and structures for VSB
  44. that are also used in user mode
  45. Makefile&#9; The makefile for the project; do not edit.
  46. Medguid.h&#9; Contains definitions of medium GUIDs
  47. Mpoc.cpp&#9; Implements the MPOC-chip properties of the device class
  48. Mpoc.h&#9; Defines constants and structures for MPOC chip
  49. ObjDesc.cpp&#9; Defines automation and dispatch tables and
  50. template structures
  51. PhilTune.h&#9; Defines classes for filter, device, and filter I/O pins
  52. PhilTune.inf&#9; Installation information for the sample
  53. PhilTune.rc&#9; Version information resource
  54. Sources&#9; DDK build instructions
  55. Trnsport.cpp&#9; Implements the class for the output Transport pin
  56. Tuneprop.cpp&#9; Implements the tuner-chip properties of the device class
  57. Tuner.cpp&#9; Implements the tuner class -- Sets up the tuner node
  58. Tuner.h&#9; Defines tuner class
  59. Tunerdef.h&#9; Defines tuner constants and structures
  60. Util.cpp&#9; Implements supporting functions
  61. Util.h&#9; Defines supporting functions
  62. Vsb.h&#9; Defines constants and structures for VSB
  63. Vsb1.cpp&#9; Implements the VSBDemod1 class -- Sets the demodulator node
  64. Vsb1.h&#9; Defines the VSBDemod1 class
  65. Vsb2.cpp&#9; Implements the VSBDemod2 class -- Sets the demodulator node
  66. Vsb2.h&#9; Defines the VSBDemod2 class
  67. Vsbbase.cpp&#9; Implements the VSBDemod class -- Sets the demodulator node
  68. Vsbbase.h&#9; Defines the VSBDemod class
  69. Vsbdef.h&#9; Defines more constants and structures for VSB
  70. Vsbprop.cpp&#9; Implements the VSB properties of the device class
  71. Wdmcommon.h&#9; Defines constants and structures that are common to WDM
  72. Wdmdebug.h&#9; Contains macros for WDM debugging
  73. Wdmdrv.h&#9; Defines constants and structures for a WDM driver
  74. </PRE></FONT><FONT FACE="Verdana"><H4>Programming Tour</H4></FONT><FONT FACE="Verdana" SIZE=2><P>
  75. The ObjDesc.cpp file contains definitions and templates that the network provider filter uses to determine topology, to configure and change a filter instance, and to manipulate tuner and demodultor nodes. The BDA tuner driver registers these definitions and templates with the BDA support library so the library can handle most aspects of these operations. Other files of this sample define constants, structures, and classes and implement methods for those classes. <P>
  76. </FONT><P ALIGN="CENTER"><A HREF="#top"><FONT FACE="Verdana" SIZE=2>Top of page</FONT></A><FONT FACE="Verdana" SIZE=2> </P></FONT>
  77. <TABLE CELLSPACING=0 BORDER=0 WIDTH=624>
  78. <TR><TD VALIGN="MIDDLE" BGCOLOR="#00ffff" HEIGHT=2>
  79. <P></TD>
  80. </TR>
  81. </TABLE>
  82. <FONT FACE="MS Sans Serif" SIZE=1><P>&copy; 2000 Microsoft Corporation</FONT><FONT FACE="Verdana" SIZE=2> </P></FONT></BODY>
  83. </HTML>