Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
Vanaf Windows 11, versie 24H2, kunt u met NetAdapterCx een User-Mode Driver Framework (UMDF) schrijven netwerkadapterstuurprogramma. De UMDF-API's in NetAdapterCx zijn afgestemd op de KMDF-versies, zodat u het clientstuurprogramma op basis van KMDF kunt converteren naar UMDF met weinig tot geen codewijzigingen.
Voordelen van NetAdapterCx-stuurprogramma's in de gebruikersmodus
Het maken van een UMDF NetAdapterCx-stuurprogramma biedt de volgende voordelen:
Verbeterde systeemstabiliteit: een stuurprogramma in de gebruikersmodus heeft alleen toegang tot de adresruimte van het proces. Als het vastloopt, heeft dit geen invloed op het systeem. Het stuurprogramma kan automatisch opnieuw worden opgestart, zodat de verbinding snel kan worden hersteld.
Verbeterde beveiliging: toepassingen in de gebruikersmodus hebben geen rechtstreeks toegang tot kritieke systeemresources of voeren uitgebreide instructies uit. Een schending van de beveiliging van stuurprogramma's maakt daarom geen inbreuk op de integriteit van de kernel.
Vereenvoudigde ontwikkeling: stuurprogramma's in de gebruikersmodus kunnen de werkstroom van de ontwikkelaar verbeteren. U hoeft niet te wachten tot testmachines opnieuw worden opgestart na crashes en de implementatie kan sneller zijn door dezelfde machine te gebruiken voor ontwikkeling en testen.
Verbeterde innovatie en flexibiliteit: Ontwikkelingsbeperkingen voor stuurprogramma's in de kernelmodus beperken vaak innovatie. Stuurprogramma's in de gebruikersmodus bieden een flexibelere omgeving, zodat ontwikkelaars geavanceerde functies en hulpprogramma's kunnen gebruiken die mogelijk niet compatibel of lastig zijn om te implementeren in kernelmodus.
Beperkingen van NetAdapterCx in de gebruikersmodus
De volgende functies zijn momenteel alleen beschikbaar voor NETAdapterCx-stuurprogramma's op basis van KMDF.
Direct Memory Access (DMA)
DMA is nog niet beschikbaar in de gebruikersmodus.
UMDF-stuurprogramma's moeten het DmaCapabilities-lid in NET_ADAPTER_RX_CAPABILITIES en NET_ADAPTER_TX_CAPABILITIES instellen op NULL.
Buffertoewijzing aan clientzijde
Beheer van netwerkgegevensbuffers aan de clientzijde is niet beschikbaar in de gebruikersmodus. UMDF NetAdapterCx-stuurprogramma's moeten afhankelijk zijn van het systeem om gegevensbuffers toe te wijzen voor de gegevenspaden voor verzenden en ontvangen.
Wanneer uw UMDF-stuurprogramma de mogelijkheden van de hardwaregegevensbuffer promoot door gebruik te maken van de NET_ADAPTER_RX_CAPABILITIES-structuur, moet het:
- Stel NET_RX_FRAGMENT_BUFFER_ALLOCATION_MODE in op NetRxFragmentBufferAllocationModeSystem .
- Stel NET_RX_FRAGMENT_BUFFER_ATTACHMENT_MODE in op NetRxFragmentBufferAttachmentModeSystem.
- Stel NET_MEMORY_MAPPING_REQUIREMENT in op NetMemoryMappingRequirementNone.
Een KMDF NetAdapterCx-stuurprogramma converteren naar UMDF
Als u in de gebruikersmodus wilt werken, moet het clientstuurprogramma alleen kern-WDF-API's gebruiken die deel uitmaken van UMDF. Het clientstuurprogramma mag bijvoorbeeld geen API's gebruiken die exclusief zijn voor KMDF-stuurprogramma's.
Als u het KMDF NetAdapterCx-stuurprogramma wilt converteren naar UMDF, volgt u de stappen in Een KMDF-stuurprogramma converteren naar een UMDF 2-stuurprogramma.
De UMDF- en KMDF-versies van NetAdapterCx delen hetzelfde primaire versienummer.