A reflektor megadása INF-fájlban

A Windows 11-től kezdődően a reflektor (WUDFRd.sys) kernel módú eszközverembe való hozzáadásának ajánlott módja az, hogy a UMDF-illesztő INF-fájljában a rendszer által biztosított WudfRd.inf fájlra hivatkozik.

Megjegyzés

A WudfRd.inf csak a Windows 11 és újabb verziókban érhető el.

Windows 10 és korábbi rendszereken a tükröző (WUDFRd.sys) hozzáadásához az UMDF-illesztő INF-fájljának tartalmaznia kell egy AddService irányelvet egy INF DDInstall.Services szakaszban, valamint egy szolgáltatástelepítési szakaszt. Bár ez a módszer windows 11-en és újabb verziókban is működik, nem ajánlott.

Mindkét módszer esetében a reflektor lehet felső szintű szűrő, alsó szintű szűrő, vagy az eszköz szolgáltatása, a felhasználói módú verem konfigurációjától függően.

A WudfRd.inf (Windows 11 vagy újabb) hivatkozása

Megtalálhat egy példát arra, hogyan használja ezt a technikát az echoum.inxfájlban. Másik lehetőségként használja az alábbi kódrészletek egyikét.

A WudfRd szolgáltatás telepítése az eszköz függvényillesztőjeként:

[DDInstall]
Include=WUDFRD.inf
Needs=WUDFRD.NT
; also include any existing DDInstall directives

[DDInstall.HW]
Include=WUDFRD.inf
Needs=WUDFRD.NT.HW
; also include any existing DDInstall.HW directives

[DDInstall.Services]
Include=WUDFRD.inf
Needs=WUDFRD.NT.Services
; also include any existing any DDInstall.Services directives

A WudfRd szolgáltatás felső szűrőillesztőként való telepítéséhez:

[DDInstall] 
Include=WUDFRD.inf
Needs=WUDFRD_UpperFilter.NT
; also include any existing DDInstall directives

[DDInstall.HW]
Include=WUDFRD.inf
Needs=WUDFRD_UpperFilter.NT.HW
; also include any existing DDInstall.HW directives

[DDInstall.Services]
Include=WUDFRD.inf
Needs=WUDFRD_UpperFilter.NT.Services
; also include any existing any DDInstall.Services directives

[DDInstall.Filters]
Include=WUDFRD.inf
Needs=WUDFRD_UpperFilter.NT.Filters

A WudfRd szolgáltatás telepítése alacsonyabb szűrőillesztőként:

[DDInstall] 
Include=WUDFRD.inf
Needs=WUDFRD_LowerFilter.NT
; also include any existing DDInstall directives

[DDInstall.HW]
Include=WUDFRD.inf
Needs=WUDFRD_LowerFilter.NT.HW
; also include any existing DDInstall.HW directives

[DDInstall.Services]
Include=WUDFRD.inf
Needs=WUDFRD_LowerFilter.NT.Services
; also include any existing any DDInstall.Services directives

[DDInstall.Filters]
Include=WUDFRD.inf
Needs=WUDFRD_LowerFilter.NT.Filters

AddService-direktíva használata (Windows 10 és korábbi verziók)

Az alábbi kódpélda bemutatja, hogyan lehet az UMDF-függvényillesztő INF-fájlját a reflektor hozzáadására használni.

[Skeleton_Install.Services]
AddService=WUDFRd,0x000001fa,WUDFRD_ServiceInstall

Ebben a példában a meghajtó megadja a 0x2 (SPSVCINST_ASSOCSERVICE) jelzőt (bele-OR-olva a fenti jelzők paraméterébe), hogy a reflektort függvénymeghajtóként rendelje hozzá a kernelmódú eszközveremben.

Az AddService irányelv a 0x000001f8 jelzőket is beállítja, hogy ne írja felül a szolgáltatás korábbi konfigurációit. További információért ezekkel a jelzőkkel kapcsolatban lásd a jelzők paraméterét a AddService irányelvben.

A WUDFVhidmini mintából vett alábbi kódpélda egy AddService irányelvet mutat be egy UMDF-szűrőillesztőhöz.

[hidumdf.win8.NT.Services]
AddService=WUDFRd,0x000001f8,WUDFRD_ServiceInstall  
AddService=mshidumdf, 0x000001fa, mshidumdf.AddService

[WudfVhidmini_AddReg]
HKR,,"LowerFilters",0x00010008,"WUDFRd" ; FLG_ADDREG_TYPE_MULTI_SZ | FLG_ADDREG_APPEND

Ebben az esetben az mshidumdf szolgáltatás az eszközverem FDO-jával van társítva, a reflektor pedig egy alsó szűrő.

A szolgáltatás telepítési szakaszának biztosítása

Az AddService irányelv az alábbi kód példához hasonló szolgáltatástelepítési szakaszra hivatkozik. A ServiceType bejegyzés 1 vagy 0x00000001 ad meg, ami azt jelzi, hogy az INF egy vagy több eszköz támogatását telepíti. A StartType bejegyzés határozza meg, hogy mikor kell elindítani az illesztőprogramot. Az ErrorControl bejegyzés határozza meg az illesztőprogram által biztosított hibavezérlési szintet. A ServiceBinary bejegyzés határozza meg a szolgáltatás bináris (tükröző) elérési útját.

[WUDFRD_ServiceInstall]
DisplayName = "Windows Driver Frameworks - User-mode Driver Framework Reflector"
ServiceType=1
StartType=3
ErrorControl=1
ServiceBinary=%12%\WUDFRd.sys