Dyrektywa INF AddService

Uwaga

Ta dyrektywa nie jest używana w plikach INF, które instalują urządzenia, które nie wymagają żadnych sterowników, takich jak modemy lub monitory wyświetlania.

Dyrektywa AddService jest używana w inf DDInstall. Sekcja usług lub sekcja INF DefaultInstall.Services. Określa charakterystykę usług skojarzonych z sterownikami, takich jak sposób i czas ładowania usług, oraz wszelkie zależności od innych podstawowych starszych sterowników lub usług. Opcjonalnie ta dyrektywa konfiguruje również usługi rejestrowania zdarzeń dla urządzenia.

[DDInstall.Services] 
 
AddService=ServiceName,[flags],service-install-section
                     [,event-log-install-section[,[EventLogType][,EventName]]]
...

Wpisy

ServiceName
Określa nazwę usługi, która ma zostać zainstalowana. Nazwa powinna być wystarczająco unikatowa, że jest mało prawdopodobne, aby powodować konflikt z usługą zainstalowaną przez inny plik INF. Na przykład nazwa usługi może zawierać krótki skrót nazwy firmy jako prefiks lub sufiks. Ta nazwa nie może być zlokalizowana. Musi być taka sama, niezależnie od lokalnego języka systemu.

flags
Określa co najmniej jedną flagę zdefiniowaną przez system (ORed) zdefiniowaną w pliku Setupapi.h wyrażoną jako wartość szesnastkowa:

0x00000001 (SPSVCINST_TAGTOFRONT)
Przenieś tag nazwanej usługi na przednią część listy zamówień grupy, zapewniając, że jest on ładowany jako pierwszy w ramach tej grupy (chyba że następnie zainstalowane urządzenie z tą specyfikacją INF go wypiera). Pliki INF, które instalują wyłącznie urządzenia PnP i urządzenia ze sterownikami WDM, nie powinny ustawiać tej flagi.

0x00000002 (SPSVCINST_ASSOCSERVICE)
Przypisz nazwaną usługę jako sterownik funkcji PnP (lub starszy sterownik) dla urządzenia instalowanego przez ten plik INF.

Aby wskazać, że usługa jest sterownikiem funkcji dla urządzenia, usługa powinna określić flagę SPSVCINST_ASSOCSERVICE w dyrektywie AddService . W przypadku usługi, takiej jak sterownik filtru lub inny składnik sterownika, flaga nie powinna być używana.

Każda usługa INF sterownika urządzenia powinna mieć dokładnie jedną skojarzną usługę. InF nie wymaga skojarzonej usługi, jeśli jest to rozszerzenie INF lub używa dyrektyw Include/Needs do dziedziczenia skojarzonej usługi z innej innej inf. W przypadku urządzeń, które nie wymagają sterownika funkcji, sterownik NULL można określić jako skojarzona usługa w następujący sposób:

AddService = ,2

0x00000008 (SPSVCINST_NOCLOBBER_DISPLAYNAME)
Nie zastępowaj przyjaznej nazwy danej usługi (opcjonalnie), jeśli ta usługa już istnieje w systemie.

0x00000010 (SPSVCINST_NOCLOBBER_STARTTYPE)
Nie zastępowaj typu uruchamiania danej usługi, jeśli ta nazwana usługa już istnieje w systemie.

0x00000020 (SPSVCINST_NOCLOBBER_ERRORCONTROL)
Nie zastępowaj wartości kontroli błędów danej usługi, jeśli ta nazwana usługa już istnieje w systemie.

0x00000040 (SPSVCINST_NOCLOBBER_LOADORDERGROUP)
Nie należy zastępować wartości load-order-group danej usługi, jeśli ta nazwana usługa już istnieje w systemie. Pliki INF, które instalują wyłącznie urządzenia PnP i urządzenia ze sterownikami WDM, nie powinny ustawiać tej flagi.

0x00000080 (SPSVCINST_NOCLOBBER_DEPENDENCIES)
Nie zastępowaj listy zależności danej usługi, jeśli ta nazwana usługa już istnieje w systemie. Pliki INF, które instalują wyłącznie urządzenia PnP i urządzenia ze sterownikami WDM, nie powinny ustawiać tej flagi.

0x00000100 (SPSVCINST_NOCLOBBER_DESCRIPTION)
Nie zastępowaj opisu danej usługi (opcjonalnie), jeśli ta usługa już istnieje w systemie.

0x00000400 (SPSVCINST_CLOBBER_SECURITY) (Windows XP i nowsze wersje Windows)
Zastąp ustawienia zabezpieczeń usługi, jeśli ta usługa już istnieje w systemie.

0x00000800 (SPSVCSINST_STARTSERVICE) (Windows Vista i nowsze wersje Windows)
Uruchom usługę po zainstalowaniu usługi. Tej flagi nie można użyć do uruchomienia usługi, która implementuje sterownik funkcji Plug and Play (PnP) lub sterownik filtru dla urządzenia. W przeciwnym razie tej flagi można użyć do uruchomienia usługi trybu użytkownika lub trybu jądra zarządzanej przez menedżera kontroli usług (SCM).

0x00001000 (SPSVCINST_NOCLOBBER_REQUIREDPRIVILEGES) (Windows 7 i nowsze wersje Windows)
Nie zastępowaj uprawnień dla danej usługi, jeśli ta usługa już istnieje w systemie.

0x00002000 (SPSVCINST_NOCLOBBER_TRIGGERS) (Windows 10 w wersji 2004 i nowszych Windows)
Nie zastępowaj wyzwalaczy dla danej usługi, jeśli ta usługa już istnieje w systemie i ma istniejące wyzwalacze. Aby uzyskać więcej informacji na temat wyzwalaczy, zobacz poniższą dyrektywę AddTrigger.

0x00004000 (SPSVCINST_NOCLOBBER_SERVICESIDTYPE) (Windows 10 Wersja 2004 i nowsze wersje Windows)
Nie zastępujej informacji o identyfikatorze SID dla danej usługi, jeśli ta usługa już istnieje w systemie i ma istniejące informacje o identyfikatorze SID. Aby uzyskać więcej informacji, zobacz poniższą dyrektywę ServiceSidType.

0x00008000 (SPSVCINST_NOCLOBBER_DELAYEDAUTOSTART) (Windows 10 w wersji 2004 i nowszych Windows)
Nie zastępowaj opóźnionej wartości automatycznego uruchamiania dla danej usługi, jeśli ta usługa już istnieje w systemie i ma istniejącą wartość. Aby uzyskać więcej informacji, zobacz poniższą dyrektywę DelayedAutoStart.

0x00020000 (SPSVCINST_NOCLOBBER_FAILUREACTIONS) (Windows 11 w wersji 22H2 i nowszych wersjach Windows)
Nie zastąp akcji niepowodzenia dla danej usługi, jeśli ta usługa już istnieje w systemie i ma istniejące akcje niepowodzenia. Zobacz poniższą dyrektywę FailureActions, aby uzyskać więcej informacji na temat akcji niepowodzenia.

0x00040000 (SPSVCINST_NOCLOBBER_BOOTFLAGS) (Windows 11 kompilacji 25398 i nowszych wersji Windows) Nie zastępowaj wartości flag rozruchowych dla danej usługi, jeśli ta usługa już istnieje w systemie i ma istniejącą wartość. Aby uzyskać więcej informacji, zobacz poniższą dyrektywę BootFlags .

service-install-section
Odwołuje się do sekcji zdefiniowanej przez moduł zapisywania INF, która zawiera informacje dotyczące instalowania nazwanej usługi dla tego urządzenia (lub urządzeń). Aby uzyskać więcej informacji, zobacz następującą sekcję Uwagi .

event-log-install-section
Opcjonalnie odwołuje się do sekcji zdefiniowanej przez moduł zapisywania INF, w której są skonfigurowane usługi rejestrowania zdarzeń dla tego urządzenia (lub urządzeń).

EventLogType
Opcjonalnie określa jeden z systemów, zabezpieczeń lub aplikacji. W przypadku pominięcia ta wartość domyślna to System, która jest prawie zawsze odpowiednią wartością dla instalacji sterowników urządzeń.

Na przykład inf określi zabezpieczenia tylko wtedy, gdy sterownik to-be-installed zapewnia własną obsługę zabezpieczeń.

EventName
Opcjonalnie określa nazwę do użycia dla dziennika zdarzeń. W przypadku pominięcia ta wartość jest domyślnie ustawiona na daną nazwę usługi ServiceName.

Remarks

Rozszerzenia niewrażliwe na wielkość liter i zdefiniowane przez system można wstawić do instalacji DDInstall. Sekcja usług zawierająca dyrektywę AddService w plikach INF międzyplatformowych i/lub międzyplatformowych w celu określenia instalacji specyficznych dla platformy lub systemu operacyjnego.

Każda nazwa sekcji utworzonej przez moduł zapisywania INF musi być unikatowa w pliku INF i musi być zgodna z ogólnymi regułami definiowania nazw sekcji. Aby uzyskać więcej informacji na temat tych reguł, zobacz Ogólne reguły składni dla plików INF.

Dyrektywa AddService musi odwoływać się do nazwanej sekcji service-install-section w innym miejscu w pliku INF. Każda taka sekcja ma następującą formę:

[service-install-section]
 
[DisplayName=name]
[Description=description-string]
ServiceType=type-code
StartType=start-code
ErrorControl=error-control-level
ServiceBinary=path-to-service
[StartName=service-start-name]
[AddReg=add-registry-section[, add-registry-section] ...]
[DelReg=del-registry-section[, del-registry-section] ...]
[BitReg=bit-registry-section[,bit-registry-section] ...]
[LoadOrderGroup=load-order-group-name]
[Dependencies=depend-on-item-name[,depend-on-item-name]
[Security="security-descriptor-string"]...]
[RequiredPrivileges=privilege-name[,privilege-name]...] (Windows 7 and later versions of Windows)
[ServiceSidType=value] (Windows 10 Version 2004 and later versions of Windows)
[DelayedAutoStart=value] (Windows 10 Version 2004 and later versions of Windows)
[AddTrigger=service-trigger-install-section[, service-trigger-install-section, ...]] (Windows 10 Version 2004 and later versions of Windows)
[FailureActions=service-failure-actions-install-section] (Windows 11 version 22H2 and later versions of Windows)
[BootFlags=value] (Windows 11 build 25398 and later versions of Windows)

Każda sekcja service-install-musi zawierać co najmniej wpisy ServiceType, StartType, ErrorControl i ServiceBinary , jak pokazano tutaj. Pozostałe wpisy są jednak opcjonalne.

Service-Install wpisy i wartości sekcji

DisplayName=nazwa
Określa przyjazną nazwę dla usługi/sterownika, zwykle w celu ułatwienia lokalizacji, wyrażonej jako %strkey% token zdefiniowany w sekcji Ciągi pliku INF.

Opis=description-string
Opcjonalnie określa ciąg opisujący usługę, zwykle wyrażony jako %strkey% token zdefiniowany w sekcji Ciągi pliku INF.

Ten ciąg udostępnia użytkownikowi więcej informacji o usłudze niż DisplayName. Na przykład nazwa Wyświetlana Może być podobna do "Klient DHCP", a opis może być podobny do "Zarządza konfiguracją sieci, rejestrując i aktualizując adresy IP i nazwy DNS".

Ciąg opisu powinien być wystarczająco długi, aby był opisowy, ale nie tak długo, jak niezręczny. Jeśli ciąg-opisu zawiera jakiekolwiek %strkey% tokeny, każdy token może reprezentować maksymalnie 511 znaków. Łączny ciąg po podstawieniu tokenu ciągu nie powinien przekraczać 1024 znaków.

ServiceType=type-code
Kod typu sterownika urządzenia w trybie jądra musi być ustawiony na 0x00000001 (SERVICE_KERNEL_DRIVER).

Kod typu dla usługi win32 Microsoft, która jest zainstalowana dla urządzenia, powinna być ustawiona na wartość 0x00000010 (SERVICE_WIN32_OWN_PROCESS) lub 0x00000020 (SERVICE_WIN32_SHARE_PROCESS). Jeśli usługa Win32 może wchodzić w interakcje z pulpitem, wartość typu-kod powinna być połączona z 0x00000100 (SERVICE_INTERACTIVE_PROCESS).

Kod typu dla sterownika sieciowego najwyższego poziomu, takiego jak przekierowanie lub sterownik systemu plików, powinien być ustawiony na 0x00000002 (SERVICE_FILE_SYSTEM_DRIVER).

Stałe SERVICE_xxxx są definiowane w plikach Wdm.h i Ntddk.h.

= Typ rozpoczęciakod początkowy
Określa, kiedy należy uruchomić sterownik jako jedną z następujących wartości liczbowych, wyrażoną w przecinku lub, jak pokazano na poniższej liście, w notacji szesnastkowej.

0x0 (SERVICE_BOOT_START)
Wskazuje sterownik uruchomiony przez moduł ładujący systemu operacyjnego.

Ta wartość musi być używana dla sterowników urządzeń wymaganych do załadowania systemu operacyjnego.

0x1 (SERVICE_SYSTEM_START)
Wskazuje sterownik uruchomiony podczas inicjowania systemu operacyjnego.

Ta wartość powinna być używana przez sterowniki PnP, które wykonują wykrywanie urządzeń podczas inicjowania, ale nie są wymagane do załadowania systemu.

Na przykład sterownik PnP, który może również wykryć starsze urządzenie, powinien określić tę wartość w jego inf, aby jego procedura DriverEntry jest wywoływana w celu znalezienia starszego urządzenia, nawet jeśli nie można wyliczyć tego urządzenia przez menedżera PnP.

0x2 (SERVICE_AUTO_START)
Wskazuje usługę uruchomioną przez menedżera kontroli usługi podczas uruchamiania systemu.

Ta wartość nigdy nie powinna być używana w plikach INF dla sterowników urządzeń WDM lub PnP.

0x3 (SERVICE_DEMAND_START)
Wskazuje usługę uruchomioną na żądanie przez menedżera PnP, gdy odpowiednie urządzenie jest wyliczane lub ewentualnie przez menedżera kontroli usługi w odpowiedzi na jawne zapotrzebowanie użytkownika na urządzenie inne niż PnP.

Ta wartość powinna być używana w plikach INF dla wszystkich sterowników WDM urządzeń, które nie są wymagane do załadowania systemu i dla wszystkich sterowników urządzeń PnP, które nie są ani wymagane do załadowania systemu, ani wykrywania urządzeń.

0x4 (SERVICE_DISABLED)
Wskazuje usługę, której nie można uruchomić.

Ta wartość może służyć do tymczasowego wyłączania usług sterowników dla urządzenia. Nie można jednak zainstalować urządzenia/sterownika, jeśli ta wartość jest określona w sekcji service-install pliku INF.

Aby uzyskać więcej informacji o typie startowym, zobacz Określanie kolejności ładowania sterownika.

ErrorControl=poziom kontroli błędów
Określa poziom kontrolki błędów jako jedną z następujących wartości liczbowych, wyrażoną w przecinku lub, jak pokazano na poniższej liście, w notacji szesnastkowej.

0x0 (SERVICE_ERROR_IGNORE)
Jeśli nie można załadować lub zainicjować sterownika, kontynuuj uruchamianie systemu i nie wyświetlaj ostrzeżenia dla użytkownika.

0x1 (SERVICE_ERROR_NORMAL)
Jeśli sterownik nie może załadować lub zainicjować jego urządzenia, uruchomienie systemu powinno kontynuować, ale wyświetlić ostrzeżenie dla użytkownika.

0x2 (SERVICE_ERROR_SEVERE)
Jeśli nie można załadować sterownika, uruchomienie systemu powinno przełączyć się do zestawu kontrolek LastKnownGood rejestru i kontynuować uruchamianie systemu, nawet jeśli sterownik ponownie wskazuje błąd inicjowania ładowania lub urządzenia/sterownika.

0x3 (SERVICE_ERROR_CRITICAL)
Jeśli nie można załadować sterownika, a uruchomienie systemu nie korzysta z zestawu kontrolek LastKnownGood rejestru, przełącz się na LastKnownGood i spróbuj ponownie.

Jeśli uruchamianie nadal kończy się niepowodzeniem podczas korzystania z funkcji LastKnownGood, uruchom procedurę sprawdzania błędów. (Tylko urządzenia/sterowniki niezbędne do rozruchu systemu określają tę wartość w plikach INF).

ServiceBinary=ścieżka do usługi
Określa ścieżkę pliku binarnego dla usługi, wyrażoną jako %dirid%\filename.

Numer dirid jest identyfikatorem katalogu niestandardowego lub jednym z identyfikatorów katalogów zdefiniowanych przez system opisanych w temacie Using Dirids (Używanie dirids). Podana nazwa pliku określa plik już przeniesiony (zobacz dyrektywę INF CopyFiles) ze źródłowego nośnika dystrybucji do tego katalogu na komputerze docelowym.

Nazwa początkowa=service-start-name Ten opcjonalny wpis określa nazwę początkową, która powinna być skojarzona z usługą. Jeśli typ-kod określa 1 (SERVICE_KERNEL_DRIVER) lub 2 (SERVICE_FILE_SYSTEM_DRIVER), ta nazwa jest nazwą obiektu sterownika, którego menedżer we/wy używa do załadowania sterownika. Jeśli kod typu zawiera bit 0x00000010 (SERVICE_WIN32_OWN_PROCESS) lub 0x00000020 (SERVICE_WIN32_SHARE_PROCESS), ta nazwa może być jedną z prawidłowych wartości parametru lpServiceStartName interfejsu API CreateService .

DodajReg=add-registry-section[,add-registry-section]...
Odwołuje się do co najmniej jednej sekcji dodatku zdefiniowanej przez składnik zapisywania INF, w których wszystkie informacje rejestru istotne dla nowo zainstalowanych usług są skonfigurowane. Aby uzyskać więcej informacji, zobacz INF AddReg Directive (Dyrektywa INF AddReg).

DelReg=del-registry-section[,del-registry-section]...
Odwołuje się do co najmniej jednej sekcji składnika zapisywania INF zdefiniowanej w del-rejestrze , w których są usuwane odpowiednie informacje o rejestrze dla już zainstalowanych usług. Aby uzyskać więcej informacji, zobacz INF DelReg, dyrektywa.

Ta dyrektywa prawie nigdy nie jest używana w sekcji service-install-section, ale może być używana w INF, która "aktualizuje" rejestr dla poprzedniej instalacji tych samych usług urządzeń/sterowników.

BitReg=bit-registry-section[,bit-registry-section]...
Jest prawidłowy w sekcji service-install-section , ale prawie nigdy nie jest używany.

LoadOrderGroup=load-order-group-name
Ten opcjonalny wpis identyfikuje grupę kolejności ładowania, do której należy ten sterownik. Może to być jedna z "standardowych" grup kolejności ładowania, takich jak klasa SCSI lub NDIS.

Ogólnie rzecz biorąc, ten wpis jest niepotrzebny dla urządzeń ze sterownikami WDM lub wyłącznie dla urządzeń PnP, chyba że istnieją starsze zależności od takiej grupy. Ten wpis może być jednak przydatny, jeśli wykrywanie urządzeń jest obsługiwane przez załadowanie grupy sterowników w określonej kolejności.

Aby uzyskać więcej informacji na temat loadOrderGroup, zobacz Określanie kolejności ładowania sterownika.

= Zależnościdepend-on-item-name[,depend-on-item-name]... Każdy element depend-on-item-name na liście zależności określa nazwę usługi lub grupy kolejności ładowania, od której zależy urządzenie/sterownik.

Jeśli parametr depend-on-item-name określa usługę, która musi być uruchomiona przed uruchomieniem tego sterownika. Na przykład INF dla dostarczanych przez system usług drukowania TCP/IP Win32 zależy od obsługi bazowego (trybu jądra) stosu transportu TCP/IP. W związku z tym funkcja INF dla usług drukowania TCP/IP określa ten wpis jako Dependencies=TCPIP.

Nazwa zależna od elementu może określać grupę kolejności ładowania, od której zależy to urządzenie/sterownik. Taki sterownik jest uruchamiany tylko wtedy, gdy co najmniej jeden członek określonej grupy został uruchomiony. Poprzedzaj nazwę grupy znakiem plus (+). Na przykład systemowe usługi RAS INF mogą mieć wpis taki jak Dependencies = +NetBIOSGroup,RpcSS , który zawiera zarówno grupę kolejności ładowania, jak i usługę.

Security="security-descriptor-string"
Określa deskryptor zabezpieczeń, który ma zostać zastosowany do usługi. Ten deskryptor zabezpieczeń określa uprawnienia wymagane do wykonywania takich operacji jak uruchamianie, zatrzymywanie i konfigurowanie usługi. Wartość security-descriptor-string jest ciągiem z tokenami wskazującymi składnik zabezpieczeń DACL (D:).

Aby uzyskać informacje na temat ciągów deskryptora zabezpieczeń, zobacz Security Descriptor Definition Language (Windows). Aby uzyskać informacje na temat formatu ciągów deskryptora zabezpieczeń, zobacz Security Descriptor Definition Language (Windows).

Aby uzyskać więcej informacji na temat określania deskryptorów zabezpieczeń, zobacz Tworzenie bezpiecznych instalacji urządzeń.

RequiredPrivileges=privilege-name[,privilege-name]...

Uwaga

Ta wartość może być używana tylko dla usług Win32 i jest dostępna tylko w Windows 7 i powyżej.

Każda nazwa-uprawnień na liście jest nazwą uprawnienia wymaganego przez usługę. Aby uzyskać listę nazw uprawnień, zobacz Privilege Constants (Windows). Dla każdej nazwy uprawnień wymagana jest tylko nazwa tekstowa. Na przykład nazwa uprawnień powinna być zapisywana jako "SeAuditPrivilege", ale nie SE_AUDIT_NAME.

Aby uzyskać więcej informacji na temat wymaganych uprawnień usługi, zobacz SERVICE_REQUIRED_PRIVILEGES_INFO (Windows).

ServiceSidType=wartość

Uwaga

Tej wartości można używać tylko w przypadku usług Win32 i jest dostępna tylko w wersji Windows 10 w wersji 2004 lub nowszej.

Ten wpis może używać dowolnej prawidłowej wartości zgodnie z opisem w SERVICE_SID_INFO.

DelayedAutoStart=wartość

Uwaga

Tej wartości można używać tylko dla usług Win32 i jest dostępna tylko w przypadku Windows 10 2004 i nowszych.

Zawiera opóźnione ustawienie automatycznego uruchamiania usługi.

Jeśli ten element członkowski jest 0x0, usługa jest uruchamiana podczas rozruchu systemu. W przeciwnym razie usługa jest uruchamiana po uruchomieniu innych usług automatycznego uruchamiania oraz krótkim opóźnieniu.

To ustawienie jest ignorowane, chyba że usługa jest usługą automatycznego uruchamiania.

Aby uzyskać więcej informacji, zobacz tę stronę.

AddTrigger=service-trigger-install-section [, service-trigger-install-section, ...]
Określa zdarzenia wyzwalacza, które mają być zarejestrowane dla usługi Win32 , aby można było uruchomić lub zatrzymać usługę po wystąpieniu zdarzenia wyzwalacza. Aby uzyskać więcej informacji na temat zdarzeń wyzwalacza usługi, zobacz Zdarzenia wyzwalacza usługi.

Każda nazwana sekcja service-trigger-install-referenced by an AddTrigger dyrektywy ma następujący format:

[service-trigger-install-section]

TriggerType=trigger-type
Action=action-type
SubType=trigger-subtype
[DataItem=data-type,data]
...

BootFlags=wartość

Uwaga

Tej wartości można używać tylko z usługami sterowników trybu jądra i jest dostępna tylko w przypadku Windows 11 kompilacji 25398 lub nowszej.

Opcjonalnie określa, kiedy system operacyjny powinien podwyższyć poziom wartości StartType sterownika do 0x0 (SERVICE_BOOT_START). Można określić co najmniej jedną (ORed) następujących wartości liczbowych wyrażoną jako wartości szesnastkowe.

  • 0x1 (CM_SERVICE_NETWORK_BOOT_LOAD) Wskazuje, że sterownik powinien zostać podwyższony w przypadku rozruchu z sieci.

  • 0x2 (CM_SERVICE_VIRTUAL_DISK_BOOT_LOAD) Wskazuje, że sterownik powinien zostać podwyższony w przypadku rozruchu z dysku VHD.

  • 0x4 (CM_SERVICE_USB_DISK_BOOT_LOAD)
    Wskazuje, że sterownik powinien zostać podwyższony do poziomu w przypadku rozruchu z dysku USB.

  • 0x8 (CM_SERVICE_SD_DISK_BOOT_LOAD)
    Wskazuje, że sterownik powinien zostać podwyższony w przypadku rozruchu z magazynu SD.

  • 0x10 (CM_SERVICE_USB3_DISK_BOOT_LOAD)
    Wskazuje, że sterownik powinien zostać podwyższony w przypadku rozruchu z dysku na kontrolerze USB 3.0.

  • 0x20 (CM_SERVICE_MEASURED_BOOT_LOAD) Wskazuje, że sterownik powinien zostać podwyższony, jeśli rozruch podczas mierzonego rozruchu jest włączony.

  • 0x40 (CM_SERVICE_VERIFIER_BOOT_LOAD)
    Wskazuje, że sterownik powinien zostać podwyższony, jeśli rozruch z włączonym rozruchem weryfikatora.

  • 0x80 (CM_SERVICE_WINPE_BOOT_LOAD)
    Wskazuje, że sterownik powinien zostać podwyższony w przypadku rozruchu do środowiska WinPE.

Service-Trigger — wpisy i wartościInstall-Section

= Typ wyzwalaczatyp wyzwalacza
Określa typ zdarzenia wyzwalacza usługi w jednej z następujących wartości liczbowych, wyrażonych w przecinku lub, jak pokazano na poniższej liście, notacji szesnastkowej:

0x1 (SERVICE_TRIGGER_TYPE_DEVICE_INTERFACE_ARRIVAL)
Wskazuje, że zdarzenie jest wyzwalane, gdy urządzenie określonej klasy interfejsu urządzenia dociera lub występuje po uruchomieniu systemu.

Aby uzyskać więcej informacji, zobacz SERVICE_TRIGGER struktura.

Akcja=typ akcji
Określa akcję, która ma być wykonywana po wystąpieniu określonego zdarzenia wyzwalacza.

0x1 (SERVICE_TRIGGER_ACTION_SERVICE_START)
Uruchom usługę po wystąpieniu określonego zdarzenia wyzwalacza.

0x2 (SERVICE_TRIGGER_ACTION_SERVICE_STOP)
Zatrzymaj usługę po wystąpieniu określonego zdarzenia wyzwalacza.

Aby uzyskać więcej informacji, zobacz SERVICE_TRIGGER struktura.

Podtyp=podtyp wyzwalacza
Określa identyfikator GUID identyfikujący podtyp zdarzenia wyzwalacza. Wartość zależy od wartości TriggerType.

Gdy parametr TriggerType jest 0x1 (SERVICE_TRIGGER_TYPE_DEVICE_INTERFACE_ARRIVAL), podtyp określa identyfikator GUID identyfikujący klasę interfejsu urządzenia.

Aby uzyskać więcej informacji, zobacz SERVICE_TRIGGER struktura.

DataItem=typ danych, dane
Opcjonalnie określa dane specyficzne dla wyzwalacza dla zdarzenia wyzwalacza usługi.

Jeśli parametr TriggerType jest 0x1 (SERVICE_TRIGGER_TYPE_DEVICE_INTERFACE_ARRIVAL), można określić opcjonalny element DataItem z typem danych 0x2 (SERVICE_TRIGGER_DATA_TYPE_STRING), aby określić zakres klasy interfejsu urządzenia do określonego identyfikatora sprzętu lub zgodnego identyfikatora.

Aby uzyskać więcej informacji, zobacz SERVICE_TRIGGER_SPECIFIC_DATA_ITEM struktura

Najlepszym rozwiązaniem w przypadku używania dyrektywy AddTrigger jest wyzwolenie uruchamiania usługi po nadejściu interfejsu urządzenia. Aby uzyskać więcej informacji, zobacz Win32 Services Interacting with Devices (Interakcje usług Win32 z urządzeniami).

Uwaga

Składnia addTrigger jest dostępna tylko w Windows 10 wersji 2004 i do przodu.

FailureActions=service-failure-actions-install-section
Opcjonalnie określa akcję, jaką powinien wykonać kontroler usługi w przypadku awarii usługi.

Menedżer kontroli usług zlicza liczbę razy, kiedy każda usługa uległa awarii od czasu uruchomienia systemu. Liczba jest resetowana do 0, jeśli usługa nie powiodła się przez czas resetowania sekund. Gdy usługa nie powiedzie się po raz N, kontroler usługi wykonuje akcję określoną w elemecie N listy Akcja. Jeśli N jest większa niż liczba akcji, kontroler usługi powtarza ostatnią akcję na liście.

Sekcja service-failure-actions-install-referenced by a FailureActions dyrektywy ma następujący format:

[service-failure-actions-install-section]

[ResetPeriod=reset-period]
[NonCrashFailures=value]
Action=failure-action-type,delay
[Action=failure-action-type,delay]
...

Service-Failure-Actions — wpisy i wartościInstall-Section

ResetPeriod=okres resetowania
Określa czas, po którym można zresetować liczbę niepowodzeń do zera, jeśli nie ma żadnych awarii, w sekundach. Liczba niepowodzeń nie jest domyślnie resetowany, gdy nie określono okresu resetowania.

Aby uzyskać więcej informacji, zobacz SERVICE_FAILURE_ACTIONSW struktura.

NonCrashFailures=wartość
Zawiera ustawienie flagi akcji niepowodzenia usługi. To ustawienie określa, kiedy mają być wykonywane akcje niepowodzenia. Wartość 0x0 wskazuje wartość False i wartość 0x1 wskazuje wartość True.

Aby uzyskać więcej informacji, zobacz SERVICE_FAILURE_ACTIONS_FLAG struktura (winsvc.h).

Akcja=failure-action-type,delay
Określa akcję, którą może wykonać menedżer kontroli usługi. Wiele wpisów akcji tworzy uporządkowaną listę akcji niepowodzenia. Aby uzyskać więcej informacji, zobacz SC_ACTION struktura.

Uwaga

Składnia FailureActions może być używana tylko dla usług Win32 i jest dostępna od Windows 11 w wersji 22H2.

Określanie kolejności ładowania sterownika

System operacyjny ładuje sterowniki zgodnie z wartością StartTypeservice-install-section w następujący sposób:

  • W fazie uruchamiania rozruchu system operacyjny ładuje wszystkie sterowniki 0x0 (SERVICE_BOOT_START).

  • W fazie uruchamiania systemu system operacyjny najpierw ładuje wszystkie sterowniki WDM i PnP, dla których menedżer PnP znajduje węzły urządzeń (węzły devnode) (niezależnie od tego, czy ich pliki INF określają 0x01 dla SERVICE_SYSTEM_START lub 0x03 dla SERVICE_DEMAND_START). Następnie system operacyjny ładuje wszystkie pozostałe sterowniki SERVICE_SYSTEM_START.

  • W fazie automatycznego uruchamiania system operacyjny ładuje wszystkie pozostałe sterowniki SERVICE_AUTO_START.

Aby uzyskać więcej informacji na temat zależności, zobacz Określanie kolejności ładowania sterownika.

Podwyższanie typu starttype sterownika podczas rozruchu w zależności od scenariusza rozruchu

W zależności od scenariusza rozruchu można użyć wartości rejestru BootFlags do kontrolowania, kiedy system operacyjny powinien podwyższyć wartość StartType sterownika do 0x0 (SERVICE_BOOT_START). Można określić co najmniej jedną (ORed) następujących wartości liczbowych wyrażoną jako wartość szesnastkowa:

  • 0x1 (CM_SERVICE_NETWORK_BOOT_LOAD) wskazuje, że sterownik powinien zostać podwyższony w przypadku rozruchu z sieci.

  • 0x2 (CM_SERVICE_VIRTUAL_DISK_BOOT_LOAD) wskazuje, że sterownik powinien zostać podwyższony w przypadku rozruchu z dysku VHD.

  • 0x4 (CM_SERVICE_USB_DISK_BOOT_LOAD) wskazuje, że sterownik powinien zostać podwyższony do poziomu w przypadku rozruchu z dysku USB.

  • 0x8 (CM_SERVICE_SD_DISK_BOOT_LOAD) wskazuje, że sterownik powinien zostać podwyższony w przypadku rozruchu z magazynu SD.

  • 0x10 (CM_SERVICE_USB3_DISK_BOOT_LOAD) wskazuje, że sterownik powinien zostać podwyższony w przypadku rozruchu z dysku na kontrolerze USB 3.0.

  • 0x20 (CM_SERVICE_MEASURED_BOOT_LOAD) wskazuje, że sterownik powinien zostać podwyższony, jeśli rozruch podczas mierzonego rozruchu jest włączony.

  • 0x40 (CM_SERVICE_VERIFIER_BOOT_LOAD) wskazuje, że sterownik powinien zostać podwyższony, jeśli rozruch z włączonym rozruchem weryfikatora.

  • 0x80 (CM_SERVICE_WINPE_BOOT_LOAD) wskazuje, że sterownik powinien zostać podwyższony w przypadku rozruchu do środowiska WinPE.

Sekcja service-install-ma następującą ogólną formę:

[service-install-section]
AddReg=add-registry-section
...

[add-registry-section]
HKR,,BootFlags,0x00010003,0x14 ; CM_SERVICE_USB3_DISK_BOOT_LOAD|CM_SERVICE_USB_DISK_BOOT_LOAD

Uwaga

Ta składnia powinna być używana tylko w wersjach Windows i kompilacjach starszych niż Windows 11 kompilacji 25398. W przypadku Windows 11 kompilacji 25398 lub nowszej należy użyć dyrektywy BootFlags.

Rejestrowanie w celu rejestrowania zdarzeń

Dyrektywa AddService może również odwoływać się do sekcji event-log-install-w innym miejscu w pliku INF. Każda taka sekcja ma następującą formę:

[event-log-install-section]
 
AddReg=add-registry-section[, add-registry-section]...
[DelReg=del-registry-section[, del-registry-section]...] 
[BitReg=bit-registry-section[,bit-registry-section]...]
 ...

W przypadku typowego pliku INF urządzenia/sterownika sekcja event-log-install-używa tylko dyrektywy AddReg w celu skonfigurowania pliku komunikatu rejestrowania zdarzeń dla sterownika. Ta sekcja dodawania rejestru zdarzeń ma następującą ogólną formę:

[drivername_EventLog_AddReg]
HKR,,EventMessageFile,0x00020000,"path\IoLogMsg.dll;path\driver.sys"
HKR,,TypesSupported,0x00010001,7 

W szczególności sekcja dodaje dwa wpisy wartości w podkluczu rejestru utworzonym dla urządzenia/sterownika w następujący sposób:

  • Wpis wartości o nazwie EventMessageFile jest typu REG_EXPAND_SZ określony przez wartość FLG_ADDREG_TYPE_EXPAND_SZ 0x00020000. Jego wartość, ujęta w podwójny cudzysłów ("), kojarzy dostarczone przez system IoLogMsg.dll (ale może skojarzyć inną bibliotekę DLL rejestrowania) z plikiem binarnym sterownika. Zazwyczaj ścieżki do każdego z tych plików są określane w następujący sposób:

    %%SystemRoot%%\System32\IoLogMsg.dll

    %%SystemRoot%%\System32\drivers\driver.sys

  • Wpis wartości o nazwie TypesSupported jest typu REG_DWORD określony przez wartość FLG_ADDREG_TYPE_DWORD 0x00010001.

    W przypadku sterowników ta wartość powinna wynosić 7. Ta wartość jest równoważna bitowemu OR EVENTLOG_SUCCESS, EVENTLOG_ERROR_TYPE, EVENTLOG_WARNING_TYPE i EVENTLOG_INFORMATION_TYPE bez ustawiania bitów EVENTLOG_AUDIT__XXX_.

Sekcja dziennika zdarzeń install-section może również użyć dyrektywy DelReg, aby usunąć wcześniej zainstalowany plik komunikatu dziennika zdarzeń, jawnie usuwając istniejące wpisy wartości EventMessageFile i TypesSupported, jeśli plik binarny sterownika jest zastępowany przez nowo zainstalowany sterownik. (Zobacz również dyrektywę INF DelService).

Chociaż dyrektywa BitReg jest również prawidłowa wsekcji inF-zapisywania zdefiniowanej w dzienniku zdarzeń- instalacji, prawie nigdy nie jest używana, ponieważ standardowe wpisy wartości rejestrowania zdarzeń sterownika urządzenia nie są maskami bitów.

Examples

W tym przykładzie przedstawiono sekcje service-install i event-log-install, do których odwołuje się dyrektywa AddService , jak pokazano wcześniej w przykładzie narzędzia DDInstall. Usługi.

[Example_DDInstall.Services]
AddService=ExampleFunctionDriver,0x00000002,function_ServiceInstallSection
AddService=ExampleUpperFilter,,filter_ServiceInstallSection

[function_ServiceInstallSection]
DisplayName    = %function_ServiceDesc%
ServiceType    = 1
StartType      = 3
ErrorControl   = 1
ServiceBinary  = %13%\ExampleFunctionDriver.sys

[function_EventLogInstallSection]
AddReg = function_EventLog_AddReg

[function_EventLog_AddReg]
;
; Following entry on single line in INF file. Enclosing quotation marks 
; prevent the semicolon from being interpreted as a comment.
;
HKR,,EventMessageFile,0x00020000,"%%SystemRoot%%\System32\IoLogMsg.dll;
       %13%\ExampleFunctionDriver.sys"
HKR,,TypesSupported,0x00010001,7

[filter_ServiceInstallSection]
DisplayName    = %filter_ServiceDesc%
ServiceType    = 1
StartType      = 3
ErrorControl   = 1
ServiceBinary  = %13%\ExampleUpperFilter.sys

[Strings] ; only immediately preceding %strkey% tokens shown here
%function_ServiceDesc%="Example function driver service"
%filter_ServiceDesc%="Example filter driver service"

Informacje dodatkowe