Tryb użytkownika NetAdapterCx

Począwszy od systemu Windows 11, wersja 24H2, NetAdapterCx umożliwia napisanie User-Mode Driver Framework (UMDF) sterownika karty sieciowej. Interfejsy API UMDF w systemie NetAdapterCx są zgodne z wersjami usługi KMDF, co umożliwia konwertowanie sterownika klienta opartego na usłudze KMDF na usługę UMDF z niewielkimi zmianami w kodzie.

Zalety sterowników NetAdapterCx w trybie użytkownika

Utworzenie sterownika NetAdapterCx UMDF oferuje następujące korzyści:

1. ulepszona stabilność systemu: sterownik trybu użytkownika może uzyskiwać dostęp tylko do przestrzeni adresowej procesu. Jeśli wystąpi awaria, nie wpływa to na system. Sterownik może automatycznie ponownie uruchomić, szybko przywracając połączenie.

2. ulepszone zabezpieczenia: aplikacje w trybie użytkownika nie mogą bezpośrednio uzyskiwać dostępu do krytycznych zasobów systemowych ani wykonywać instrukcji uprzywilejowanych. W związku z tym każde naruszenie zabezpieczeń sterowników nie narusza integralności jądra.

3. uproszczone programowanie: sterowniki trybu użytkownika mogą zwiększyć przepływ pracy dewelopera. Nie trzeba czekać na ponowne uruchomienie maszyn testowych po awarii, a wdrożenie może być szybsze przy użyciu tej samej maszyny do programowania i testowania.

4. Zwiększone innowacje i elastyczność: Ograniczenia dotyczące opracowywania sterowników w trybie jądra często ograniczają innowacje. Sterowniki trybu użytkownika zapewniają bardziej elastyczne środowisko, dzięki czemu deweloperzy mogą korzystać z zaawansowanych funkcji i narzędzi, które mogą być niezgodne lub trudne do zaimplementowania w trybie jądra.

Ograniczenia trybu użytkownika NetAdapterCx

Następujące funkcje są obecnie dostępne tylko dla sterowników NetAdapterCx opartych na usłudze KMDF.

Bezpośredni dostęp do pamięci (DMA)

Narzędzie DMA nie jest jeszcze dostępne w trybie użytkownika.

Sterowniki UMDF muszą ustawić element członkowski DmaCapabilities w NET_ADAPTER_RX_CAPABILITIES i NET_ADAPTER_TX_CAPABILITIES na NULL.

Alokacja buforu po stronie klienta

Zarządzanie buforem danych sieciowych po stronie klienta nie jest dostępne w trybie użytkownika. Sterowniki NetAdapterCx UMDF muszą polegać na systemie w celu przydzielenia buforów danych dla ścieżek transmisji i odbierania danych.

Gdy sterownik UMDF deklaruje swoje możliwości buforu danych sprzętowych przy użyciu struktury NET_ADAPTER_RX_CAPABILITIES, musi:

• Ustaw NET_RX_FRAGMENT_BUFFER_ALLOCATION_MODE na NetRxFragmentBufferAllocationModeSystem.
• Ustaw NET_RX_FRAGMENT_BUFFER_ATTACHMENT_MODE na NetRxFragmentBufferAttachmentModeSystem.
• Ustaw wartość NET_MEMORY_MAPPING_REQUIREMENT na NetMemoryMappingRequirementNone.

Konwertuj sterownik NetAdapterCx z KMDF na UMDF

Aby działać w trybie użytkownika, sterownik klienta musi używać tylko podstawowych interfejsów API usługi WDF, które są częścią funkcji UMDF. Na przykład sterownik klienta nie może używać żadnych interfejsów API wyłącznie dla sterowników KMDF.

Aby przekonwertować sterownik KMDF NetAdapterCx na UMDF, wykonaj kroki opisane w Jak przekonwertować sterownik KMDF na sterownik UMDF 2.

Wersje UMDF i KMDF NetAdapterCx mają wspólny numer głównej wersji .