Wytyczne dotyczące MiniportInitializeEx dla sterowników PF Miniport

W tym temacie opisano wytyczne dotyczące pisania funkcji MiniportInitializeEx dla sterownika miniportu funkcji fizycznej PCI Express (PCIe). PF jest składnikiem karty sieciowej, która obsługuje wirtualizację I/O z jednym korzeniem (SR-IOV).

Uwaga te wytyczne dotyczą tylko sterowników miniportu PF. Aby uzyskać wskazówki dotyczące inicjowania sterownika miniportu Wirtualnej Funkcji (VF) PCIe karty, zobacz Inicjowanie sterownika miniportu VF.

Sterownik miniportu PF wykonuje te same kroki co każdy sterownik miniportu NDIS, gdy wykonuje swoją funkcję MiniportInitializeEx. Aby uzyskać więcej informacji na temat tych kroków, zobacz Inicjowanie sterownika miniportu.

Oprócz tych kroków sterownik miniportu PF musi wykonać następujące dodatkowe kroki, gdy usługa NDIS wywołuje funkcję MiniportInitializeEx sterownika:

1. Sterownik miniportu PF wywołuje funkcję NdisGetHypervisorInfo , aby sprawdzić, czy jest ona uruchomiona w partycji nadrzędnej Hyper-V. Ta funkcja zwraca strukturę NDIS_HYPERVISOR_INFO definiującą typ partycji. Jeśli typ partycji jest zgłaszany jako NdisHypervisorPartitionMsHvParent, sterownik miniportu jest uruchomiony w partycji nadrzędnej Hyper-V dołączonej do PF na karcie sieciowej.

   Nuta Jeśli zgłaszany typ partycji to NdisHypervisorPartitionMsHvChild, sterownik miniportu działa w podrzędnej partycji Hyper-V, która jest dołączona do VF na adapterze sieciowym. W takim przypadku sterownik miniportu nie może zostać zainicjalizowany jako sterownik PF. Jeśli to możliwe, sterownik musi zostać zainicjowany jako sterownik VF, jak opisano w Inicjowanie sterownika VF Miniport.

2. Sterownik miniportu PF musi odczytać ustandaryzowane słowa kluczowe SR-IOV, aby określić, czy SR-IOV jest włączone, i uzyskać ustawienia konfiguracji przełącznika kart sieciowej. Aby uzyskać więcej informacji na temat tych słów kluczowych, zobacz Ustandaryzowane słowa kluczowe INF dla sr-IOV.

   Uwaga Jeśli sterownik miniportu PF zarejestrował punkt zaczepienia do funkcji MiniportSetOptions, sterownik mógł wcześniej uzyskać te ustawienia z rejestru, kiedy NDIS wywołał MiniportSetOptions.

3. Jeśli karta sieciowa obsługuje funkcję SR-IOV, kolejkę maszyny wirtualnej (VMQ) lub RSS, sterownik miniportu musi określić, która funkcja ma być włączona na karcie sieciowej. Aby uzyskać więcej informacji na temat określania tego problemu, zobacz Obsługa słów kluczowych INF w standardzie SR-IOV, VMQ i RSS.

4. Wraz z możliwościami sprzętowymi RSS i VMQ (jeśli są obsługiwane), sterownik miniportu musi zgłosić pełny zestaw funkcji SR-IOV sprzętowych. Te funkcje muszą być ogłaszane niezależnie od standardowych ustawień słów kluczowych SR-IOV w rejestrze.

   Jeśli SR-IOV jest włączona na karcie sieciowej, sterownik miniportu musi również zgłosić aktualnie dostępne ustawienia SR-IOV na karcie.

   Aby uzyskać więcej informacji na temat raportowania możliwości SR-IOV, zobacz Określanie możliwości SR-IOV.

5. Sterownik miniportu musi zgłosić pełny zestaw możliwości sprzętowego przełącznika NIC. Możliwości te muszą być ogłaszane niezależnie od ustandaryzowanych ustawień słów kluczowych SR-IOV w rejestrze.

   Jeśli SR-IOV jest włączony na adapterze sieciowym, sterownik miniportu musi również zgłosić aktualnie włączone ustawienia przełącznika kontrolera interfejsu sieciowego na adapterze.

   Aby uzyskać więcej informacji na temat raportowania możliwości przełącznika karty sieciowej, zobacz Określanie możliwości przełącznika karty sieciowej.

6. Sterownik miniportu musi zgłosić pełny zestaw funkcji filtrowania odbiorczego sprzętowego. Te możliwości muszą być ogłaszane niezależnie od zunifikowanych ustawień słów kluczowych SR-IOV w rejestrze.

   Jeśli SR-IOV jest włączona na karcie sieciowej, sterownik miniportu musi również zgłosić obecnie włączone ustawienia filtrowania odbioru na karcie sieciowej.

   Aby uzyskać więcej informacji na temat raportowania możliwości filtrowania odbierania, zobacz Określanie możliwości filtrowania odbierania.

7. Jeśli sterownik miniportu obsługuje tworzenie statycznego przełącznika NIC, musi wykonać następujące czynności w kontekście wywołania funkcji MiniportInitializeEx.

   • Sterownik konfiguruje sprzęt adaptera na podstawie standardowych ustawień słowa kluczowego przełącznika karty sieciowej. Na podstawie tych ustawień sterownik przydziela niezbędne zasoby sprzętowe i programowe dla przełącznika karty sieciowej.

   • Sterownik miniportu wywołuje NdisMEnableVirtualization, aby włączyć SR-IOV i ustawić liczbę funkcji wirtualnych (VF) na karcie sieciowej. Ta funkcja konfiguruje rozszerzoną funkcję SR-IOV w przestrzeni konfiguracji PCI adaptera. Jeśli ta funkcja zwróci NDIS_STATUS_SUCCESS, SR-IOV jest włączona, a pliki VFs są uwidocznione za pośrednictwem interfejsu PCIe.

   Aby uzyskać więcej informacji, zobacz Statyczne tworzenie przełącznika interfejsu sieciowego.

   Nuta Jeśli sterownik miniportu obsługuje dynamiczne tworzenie przełącznika karty sieciowej, tworzy przełącznik i włącza wirtualizację, gdy obsługuje żądanie metody identyfikatora obiektu (OID) OID_NIC_SWITCH_CREATE_SWITCH. Aby uzyskać więcej informacji, zobacz Dynamiczne tworzenie przełącznika kart interfejsu sieciowego.