153 lines
3.9 KiB
HTML
153 lines
3.9 KiB
HTML
<HTML>
|
|
<BODY>
|
|
|
|
<FONT FACE=VERDANA SIZE=2 COLOR="#000000">
|
|
|
|
<DL>
|
|
<DT><B><A HREF="AC97SMPL.HTML#LP_REG_SECT" TARGET="LP_INFSRC">
|
|
[AC97SMPL_Service_Install]</A></B></DT>
|
|
|
|
<DD>The <I>service-install-section</I> uses specific directives to install the services of this driver.</DD>
|
|
<DD><P>Any <I>service-install-section</I> must have at least the <B>ServiceType</B>, <B>StartType</B>, <B>ErrorControl</B>, and <B>ServiceBinary</B> entries as shown below, but the remaining entries are optional. </DD>
|
|
<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_DDInstallServices"><I>DDInstall</I>.Services</A></B>.</DD>
|
|
|
|
<DD><H4>Entries and Values</H4></DD>
|
|
|
|
<DL>
|
|
<DT><B><A NAME=KWD_DISPLAYNAME>
|
|
DisplayName</A>=</B><I>name</I></DT>
|
|
<DD>Specifies a friendly name for the service, usually, for ease of localization, expressed as a <B>%</B><I>strkey</I><B>%</B> token defined in a <B>Strings</B> section of the INF file. </DD>
|
|
<DL>
|
|
<DT><P>Definition :</DT>
|
|
<DD><B><A HREF="AC97SMPL.HTML#LP_SVCINST_SECT" TARGET="LP_INFSRC">
|
|
[AC97SMPL_Service_Inst]</A></B><BR>...<BR>
|
|
DisplayName = %AC97SMPL.SvcDesc%</DD>
|
|
|
|
<DT><P>String token used :</DT>
|
|
<DD><B><A HREF="AC97SMPL.HTML#LP_STRINGS_SECT" TARGET="LP_INFSRC">
|
|
[Strings]</A></B><BR>...<BR>
|
|
AC97SMPL.SvcDesc = "Service for AC'97 Sample Driver (WDM)"</DD>
|
|
|
|
<DT><P>and localized version :</DT>
|
|
<DD><B><A HREF="AC97SMPL.HTML#LP_STRINGSLOC_SECT" TARGET="LP_INFSRC">
|
|
[Strings.0407]</A></B><BR>...<BR>
|
|
AC97SMPL.SvcDesc = "Installationshilfe für AC'97 Treiberbeispiel (WDM)"
|
|
</DL>
|
|
|
|
<DT><P><B><A NAME=KWD_SERVICETYPE>
|
|
ServiceType</A>=</B><I>type-code</I></DT>
|
|
<DD>In any INF that installs support for one or more devices, the <I>type-code</I> specification must be <B>1</B> or <B>0x00000001</B>, that is, equivalent to SERVICE_KERNEL_DRIVER.
|
|
</DD>
|
|
|
|
<DT><P><B><A NAME=KWD_STARTTYPE>
|
|
StartType</A>=</B><I>start-code</I></DT>
|
|
<DD>Specifies when to start the driver as a numerical value, expressed either in decimal or, as shown here, in hexadecimal notation.
|
|
<DL>
|
|
|
|
<DT><B>0x3</B> (SERVICE_DEMAND_START) </DT>
|
|
<DD>Indicates a driver started on demand, either by the PnP Manager when the corresponding device is enumerated or possibly by the Service Control Manager in response to an explicit user demand for a nonPnP device.
|
|
</DD>
|
|
|
|
</DL>
|
|
</DD>
|
|
|
|
<DT><B><P><A NAME=KWD_ErrorControl>
|
|
ErrorControl</A>=</B><I>error-control-level</I></DT>
|
|
<DD>Specifies the level of error control as a numerical value, expressed either in decimal or, as shown here, in hexadecimal notation.
|
|
<DL>
|
|
<DT><B>0x1</B> (SERVICE_ERROR_NORMAL) </DT>
|
|
<DD>If the driver fails to load or initialize its device, system startup should proceed but display a warning to the user. </DD>
|
|
</DL>
|
|
</DD>
|
|
|
|
<DT><B><P><A NAME=KWD_ServiceBinary>
|
|
ServiceBinary=</B><I>path-to-service</I></DT>
|
|
<DD>Specifies the path to the binary for the service, expressed as <B>%</B><I>dirid</I><B>%\</B><I>filename</I>.
|
|
<P>The <I>dirid</I> number is one of the system-defined directory identifiers already described in the reference for the <A HREF="RP_INFDEF_DESTDIR.HTML"><B>DestinationDirs</B></A> section. The given <I>filename</I> specifies a file already transferred (<I>see 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><I> directive</I>) from the source distribution media to that directory on the target machine.
|
|
<P>In this case, the binary for the service was copied in %windir%\system32\drivers, AC97SMPL.SYS.
|
|
</DD>
|
|
|
|
</DL>
|
|
</DL>
|
|
|
|
<PRE>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
</PRE>
|
|
|
|
</BODY>
|
|
</HTML>
|
|
|