163 lines
9.1 KiB
HTML
163 lines
9.1 KiB
HTML
<HTML>
|
|
<BODY>
|
|
|
|
<FONT FACE=VERDANA SIZE=2 COLOR="#000000">
|
|
|
|
<DL>
|
|
<DT><B><A HREF="AC97SMPL.HTML#LP_DDINSTALL_SECT" TARGET="LP_INFSRC">
|
|
[AC97SMPL]</A></B>,
|
|
<A HREF="AC97SMPL.HTML#LP_DDINSTALLDECNT_SECT" TARGET="LP_INFSRC"><B>
|
|
[AC97SMPL.NTX86]</A></B></DT>
|
|
|
|
|
|
<DD>The <I><B>DDInstall</B></I> section contains the instructions needed to install the driver files and to write device-specific and/or driver-specific information into the registry. Each entry is a directive and it references additional named sections in the INF being processed or in related INFs.</DD>
|
|
<DD><P>(<I><B>DDInstall</B></I> is the generic name for a device/driver installing section, as specified in the <I><B>Models</B></I> section.)</DD>
|
|
<DD><P><I>See also the </I><B><A HREF="RP_INFDEF_KEYWORDS.HTML">Glossary</A></B><I> entries for <B><A HREF="RP_INFDEF_KEYWORDS.HTML#KWD_DDInstall">[DDInstall]</A></B></I>, <I><B><A HREF="RP_INFDEF_KEYWORDS.HTML#KWD_DecoratedName">Decorated names</A></B></I>.</DD>
|
|
|
|
<H4><P><B>Entries and values</B></H4>
|
|
|
|
<DL>
|
|
|
|
<DT><A NAME=KWD_AlsoInstall><B>
|
|
AlsoInstall</B></A>=<I>inf-section-name</I>(<I>filename1.inf</I>) [<B>, </B><I>inf-section-name</I>(<I>filename2.inf</I>)]...</DT>
|
|
<DD>This directive collapses the <B>Include</B> and <B>Needs</B> directives. The needed inf sections from the included files are required to be processed in order to successfully install this device.</DD>
|
|
|
|
<DL>
|
|
<DT><P>References :</DT>
|
|
<DD><B><A HREF="AC97SMPL.HTML#LP_DDINSTALL_SECT" TARGET="LP_INFSRC">
|
|
[AC97SMPL]
|
|
</A></B><BR>...<BR>
|
|
<B>AlsoInstall</B>=KS.Registration(ks.inf), WDMAUDIO.Registration(wdmaudio.inf) (<I> both of the files are to be found in %windir%\inf</I> )</DD>
|
|
</DL>
|
|
|
|
<DD><P><B>Warning</B> : do not alter these system-provided inf files !</DD>
|
|
<DD><P><I>See also the </I><B><A HREF="RP_INFDEF_KEYWORDS.HTML">Glossary</A></B><I> entries for </I><B><A HREF="RP_INFDEF_KEYWORDS.HTML#KWD_Needs">Needs</A></B>, <B><A HREF="RP_INFDEF_KEYWORDS.HTML#KWD_Include">Include</A></B>.</DD>
|
|
|
|
<DT><A NAME=KWD_CopyFiles><P><B>
|
|
CopyFiles</B></A>=<I>file-list-section</I>[<B>,</B> <I>file-list-section</I>]...</DT>
|
|
<DD>This directive references a INF-writer-defined section which contains the device-relevant files on the source media to be transfered to the destination.</DD>
|
|
<DD><P>In this case, the files needed to be transfered are listed in the <B><A HREF="AC97SMPL.HTML#LP_SMPLCPYLST_SECT" TARGET="LP_INFSRC">[AC97SMPL.CopyList]</A></B> section.</DD>
|
|
|
|
<DL>
|
|
<DT><P>References :</DT>
|
|
<DD><B><A HREF="AC97SMPL.HTML#LP_DDINSTALL_SECT" TARGET="LP_INFSRC">
|
|
[AC97SMPL]
|
|
</A></B><BR>...<BR>
|
|
<B>CopyFiles</B>=<A HREF="AC97SMPL.HTML#LP_SMPLCPYLST_SECT" TARGET="LP_INFSRC">AC97SMPL.CopyList</A>. (<I>for all platforms</I>)</DD>
|
|
|
|
<DD><P><B><A HREF="AC97SMPL.HTML#LP_DDINSTALLDECNT_SECT" TARGET="LP_INFSRC">
|
|
[AC97SMPL.NTX86]
|
|
</A></B><BR>...<BR>
|
|
<B>CopyFiles</B>=<A HREF="AC97SMPL.HTML#LP_SMPLCPYLST_SECT" TARGET="LP_INFSRC">AC97SMPL.CopyList</A>,
|
|
<A HREF="AC97SMPL.HTML#LP_PROPCPYLST_SECT" TARGET="LP_INFSRC">AC97PROP.CopyList</A>. (<I>for Windows 2000 only</I>)</DD>
|
|
</DL>
|
|
|
|
<DD><P><I>See also the </I><B><A HREF="RP_INFDEF_KEYWORDS.HTML">Glossary</A></B><I> entry for </I><B><A HREF="RP_INFDEF_KEYWORDS.HTML#KWD_CopyFiles">CopyFiles</A></B>.</DD>
|
|
|
|
<DT><A NAME=KWD_AddReg><P><B>
|
|
AddReg</A></B>=<I>add-registry-section</I>[<B>,</B> <I>add-registry-section</I>]..</DT>
|
|
<DD>This directive references several INF-writer-defined sections () in which new subkeys are specified to be written into the registry.</DD>
|
|
|
|
<DL>
|
|
<DT><P>References :</DT>
|
|
<DD><B><A HREF="AC97SMPL.HTML#LP_DDINSTALL_SECT" TARGET="LP_INFSRC">
|
|
[AC97SMPL]
|
|
</A></B><BR>...<BR>
|
|
<B>AddReg</B>=<A HREF="AC97SMPL.HTML#LP_REG_SECT" TARGET="LP_INFSRC">AC97SMPL.AddReg</A>,<A HREF="AC97SMPL.HTML#LP_NMREG_SECT" TARGET="LP_INFSRC">AC97SMPL_NAMES.AddReg</A>, <A HREF="AC97SMPL.HTML#LP_OEMREG_SECT" TARGET="LP_INFSRC">AC97SMPL_OEM.AddReg</A></DD>
|
|
|
|
<DD><P><B><A HREF="AC97SMPL.HTML#LP_DDINSTALLDECNT_SECT" TARGET="LP_INFSRC">
|
|
[AC97SMPL.NTX86]
|
|
</A></B><BR>...<BR>
|
|
<B>AddReg</B>=<A HREF="AC97SMPL.HTML#LP_REG_SECT" TARGET="LP_INFSRC">AC97SMPL.AddReg</A>,<A HREF="AC97SMPL.HTML#LP_NMREG_SECT" TARGET="LP_INFSRC">AC97SMPL_NAMES.AddReg</A>, <A HREF="AC97SMPL.HTML#LP_OEMREG_SECT" TARGET="LP_INFSRC">AC97SMPL_OEM.AddReg</A>, <A HREF="AC97SMPL.HTML#LP_PROPREG_SECT" TARGET="LP_INFSRC">AC97PROP.AddReg</A></DD>
|
|
|
|
<DD><P><B><A HREF="AC97SMPL.HTML#LP_IWV_SECT" TARGET="LP_INFSRC">
|
|
[AC97SMPL.Interface.Wave]
|
|
</A></B><BR>...<BR>
|
|
<B>AddReg</B>=<A HREF="AC97SMPL.HTML#LP_IWVREG_SECT" TARGET="LP_INFSRC">AC97SMPL.I.Wave.AddReg</A></DD>
|
|
|
|
<DD><P><B><A HREF="AC97SMPL.HTML#LP_ITOP_SECT" TARGET="LP_INFSRC">
|
|
[AC97SMPL.Interface.Topology]
|
|
</A></B><BR>...<BR>
|
|
<B>AddReg</B>=<A HREF="AC97SMPL.HTML#LP_ITOPREG_SECT" TARGET="LP_INFSRC">AC97SMPL.I.Topo.AddReg</A></DD>
|
|
</DL>
|
|
|
|
<DD><P><I>See also the </I><B><A HREF="RP_INFDEF_KEYWORDS.HTML">Glossary</A></B><I> entry for </I><B><A HREF="RP_INFDEF_KEYWORDS.HTML#KWD_AddReg">AddReg</A></B>.</DD>
|
|
|
|
<DT><A NAME=KWD_Include><B><P>
|
|
Include</B></A>=<I>filename.inf</I>[<B>,</B> <I>filename.inf</I>]...</DT>
|
|
<DD>Specifies other INF files that have to be processed for this installation to succeed. Usually accompanied by a <B>Needs</B> directive, to specify which sections in these files are to be processed.</DD>
|
|
|
|
<DL>
|
|
<DT><P>References :</DT>
|
|
<DD><P><B><A HREF="AC97SMPL.HTML#LP_DDINSTALLDECNT_SECT" TARGET="LP_INFSRC">
|
|
[AC97SMPL.NTX86]
|
|
</A></B><BR>...<BR>
|
|
<B>Include</B>=ks.inf, wdmaudio.inf</DD>
|
|
</DL>
|
|
|
|
<DD><P><I>See also the </I><B><A HREF="RP_INFDEF_KEYWORDS.HTML">Glossary</A></B><I> entry for </I><B><A HREF="RP_INFDEF_KEYWORDS.HTML#KWD_Include">Include</A></B>.</DD>
|
|
|
|
<DT><A NAME=KWD_Needs><B><P>
|
|
Needs</B></A>=<I>inf-section-name</I>[<B>,</B> <I>inf-section-name</I>]...</DT>
|
|
<DD>Specifies section names of <B>Include</B>d INF files that have to be processed for this installation to succeed.</DD>
|
|
|
|
<DL>
|
|
<DT><P>References :</DT>
|
|
<DD><P><B><A HREF="AC97SMPL.HTML#LP_DDINSTALLDECNT_SECT" TARGET="LP_INFSRC">
|
|
[AC97SMPL.NTX86]
|
|
</A></B><BR>...<BR>
|
|
<B>Needs</B>=KS.Registration, WDMAUDIO.Registration</DD>
|
|
</DL>
|
|
|
|
<DD><P><I>See also the </I><B><A HREF="RP_INFDEF_KEYWORDS.HTML">Glossary</A></B><I> entry for </I><B><A HREF="RP_INFDEF_KEYWORDS.HTML#KWD_Needs">Needs</A></B>.</DD>
|
|
|
|
<DT><A NAME=KWD_KnownRegEntries><B><P>
|
|
KnownRegEntries</B></A></DT>
|
|
<DD>The <B>KnownRegEntries</B> directive, along with the
|
|
<B><A HREF="AC97SMPL.HTML#LP_KNWNREG_SECT" TARGET="LP_INFSRC">[AC97.KnownRegEntries]</A></B> and
|
|
<B><A HREF="AC97SMPL.HTML#LP_ISWIN98GOLD_SECT" TARGET="LP_INFSRC">[IsWin98Gold]</A></B> sections,
|
|
form a mechanism used to differentiate between WDM Audio versions 1.0 (Win98 Gold) and 1.1 (Win98 SE and Win2000).
|
|
The WDM Audio version 1.0 does not offer all of the functionality made available by version 1.1 and audio devices that support hardware mixing have to be prevented to be installed on Win98 Gold. The mechanism to be used is described below :</DD>
|
|
|
|
<DD><B>[<I>DDInstall</I>]</B><BR>...<BR>
|
|
<B>KnownRegEntries</B>=Xxx.KnownRegEntries<BR><BR>
|
|
<B>[Xxx.KnownRegEntries]</B><BR>...<BR>
|
|
<B>IsWin98Gold</B>=keep<BR><BR>
|
|
<B>[IsWin98Gold]</B><BR>...<BR>
|
|
1=HKLM,Software\Microsoft\Windows\CurentVersion,VersionNumber,0,4.10.1998
|
|
</DD>
|
|
<DD><P><B>Warning : </B>The reg entry above is to be used verbatim, any mismatches may result in incorrect device/driver setup.</DD>
|
|
<DD><P><I>The terms in bold are reserved keywords.</I></DD>
|
|
|
|
|
|
<DT><A NAME=KWD_ExcludeId><B><P>
|
|
ExcludeID</b></a>=<i>device-identification-string</i>[<b>,</b><i>device-identification-string</i>]...</dt>
|
|
<dd>(<i>Windows XP and later</i>.) This directive specifies one or more
|
|
device identification strings (either hardware IDs or compatible IDs). The <i>
|
|
DDInstall</i> section will not install devices having device IDs that match any of
|
|
the hardware IDs or compatible IDs listed.<br>
|
|
In this sample, the driver installs on a class of HW devices. On
|
|
some ac97 controller/codec combinations the driver won't work
|
|
correctly due to incompatible ac97 codecs. With this directive you
|
|
can exclude installation of the sample driver on those devices.</dd>
|
|
|
|
<DL>
|
|
<DT><P>References :</DT>
|
|
<DD><P><B><A HREF="AC97SMPL.HTML#LP_DDINSTALLDEC_SECT" TARGET="LP_INFSRC">
|
|
[AC97SMPL]
|
|
</A></B><BR>...<BR>
|
|
<B>ExcludeId</B>=PCI\VEN_8086&DEV_2415&SUBSYS_536011D4&REV_00</DD>
|
|
|
|
<DD><P><B><A HREF="AC97SMPL.HTML#LP_DDINSTALLDECNT_SECT" TARGET="LP_INFSRC">
|
|
[AC97SMPL.NTX86]
|
|
</A></B><BR>...<BR>
|
|
<B>ExcludeId</B>=PCI\VEN_8086&DEV_2415&SUBSYS_536011D4&REV_00</DD>
|
|
</DL>
|
|
|
|
<DD><P><I>See also the </I><B><A HREF="RP_INFDEF_KEYWORDS.HTML">Glossary</A></B><I> entry for </I><B><A HREF="RP_INFDEF_KEYWORDS.HTML#KWD_ExcludeId">ExcludeId</A></B>.</DD>
|
|
|
|
</DL>
|
|
|
|
</BODY>
|
|
</HTML>
|