MiniportInitializeEx-Richtlinien für PF Miniport-Treiber

In diesem Thema werden die Richtlinien zum Schreiben einer MiniportInitializeEx-Funktion für den Miniporttreiber der physischen Funktion von PCI Express (PCIe) beschrieben. Die PF ist eine Komponente eines Netzwerkadapters, die die Einzelstamm-E/A-Virtualisierung (SR-IOV) unterstützt.

Anmerkung Diese Richtlinien gelten nur für PF-Miniporttreiber. Initialisierungsrichtlinien für den Miniporttreiber einer PCIe Virtual Function (VF) des Adapters finden Sie unter Initialisieren eines VF Miniport-Treibers.

Der PF miniport-Treiber folgt den gleichen Schritten wie jeder NDIS-Miniporttreiber bei der MiniportInitializeEx-Funktion . Weitere Informationen zu diesen Schritten finden Sie unter Initialisieren eines Miniporttreibers.

Zusätzlich zu diesen Schritten muss der PF-Miniporttreiber diese zusätzlichen Schritte ausführen, wenn NDIS die MiniportInitializeEx-Funktion des Treibers aufruft:

1. Der PF-Miniport-Treiber ruft die NdisGetHypervisorInfo-Funktion auf, um zu überprüfen, ob er in der übergeordneten Hyper-V Partition ausgeführt wird. Diese Funktion gibt eine NDIS_HYPERVISOR_INFO Struktur zurück, die den Partitionstyp definiert. Wenn der Partitionstyp als NdisHypervisorPartitionMsHvParent gemeldet wird, wird der Miniporttreiber in der Hyper-V übergeordneten Partition ausgeführt, die an den PF auf dem Adapter angeschlossen ist.

   Anmerkung Wenn der Partitionstyp als NdisHypervisorPartitionMsHvChild gemeldet wird, wird der Miniporttreiber in der Hyper-V untergeordneten Partition ausgeführt, die an einen VF auf dem Adapter angefügt ist. In diesem Fall darf der Miniporttreiber nicht als PF-Treiber initialisiert werden. Wenn möglich, muss der Treiber als VF-Treiber initialisiert werden, wie im Initialisieren eines VF Miniport-Treibers beschrieben.

2. Der PF-Miniporttreiber muss die SR-IOV standardisierten Schlüsselwörter lesen, um festzustellen, ob SR-IOV aktiviert ist und die Konfigurationseinstellungen für den NIC-Switch abrufen. Weitere Informationen zu diesen Schlüsselwörtern finden Sie unter Standardisierte INF-Schlüsselwörter für SR-IOV.

   Anmerkung Wenn der PF Miniport-Treiber einen Einstiegspunkt zu einer MiniportSetOptions-Funktion registriert hat, hat der Treiber diese Einstellungen möglicherweise zuvor aus der Registrierung erhalten, wenn NDIS Als MiniportSetOptions bezeichnet wird.

3. Wenn der Netzwerkadapter SR-IOV, VMQ (Virtual Machine Queue) oder RSS unterstützt, muss der Miniporttreiber bestimmen, welches Feature auf dem Netzwerkadapter aktiviert werden soll. Weitere Informationen dazu, wie Sie dies ermitteln können, finden Sie unter "Handling SR-IOV", "VMQ" und "RSS Standardized INF Keywords".

4. Zusammen mit RSS- und VMQ-Hardwarefunktionen (sofern unterstützt) muss der Miniporttreiber seinen vollständigen Satz von Hardware-SR-IOV-Funktionen melden. Diese Funktionen müssen unabhängig von den SR-IOV standardisierten Schlüsselworteinstellungen in der Registrierung angekündigt werden.

   Wenn SR-IOV auf dem Netzwerkadapter aktiviert ist, muss der Miniporttreiber auch die aktuell verfügbaren SR-IOV Einstellungen auf dem Adapter melden.

   Weitere Informationen zum Melden der SR-IOV-Funktionen finden Sie unter Ermitteln SR-IOV Funktionen.

5. Der Miniporttreiber muss seinen vollständigen Satz von Hardware-NIC-Switchfunktionen melden. Diese Funktionen müssen unabhängig von den SR-IOV standardisierten Schlüsselworteinstellungen in der Registrierung angekündigt werden.

   Wenn SR-IOV auf dem Netzwerkadapter aktiviert ist, muss der Miniporttreiber auch die aktuell aktivierten NIC-Switcheinstellungen auf dem Adapter melden.

   Weitere Informationen zum Melden der NIC-Switch-Funktionen finden Sie unter Ermitteln der NIC-Switch-Funktionen.

6. Der Miniporttreiber muss seinen vollständigen Satz an Hardware-Empfangsfilterfähigkeiten melden. Diese Funktionen müssen unabhängig von den SR-IOV standardisierten Schlüsselworteinstellungen in der Registrierung angekündigt werden.

   Wenn SR-IOV auf dem Netzwerkadapter aktiviert ist, muss der Miniporttreiber auch die aktuell aktivierten Empfangsfiltereinstellungen auf dem Adapter melden.

   Weitere Informationen zum Melden der Empfangsfilterfunktionen finden Sie unter Ermitteln von Empfangsfilterfunktionen.

7. Wenn der Miniporttreiber die Erstellung statischer NIC-Switch unterstützt, muss er im Kontext des Aufrufs von MiniportInitializeEx folgendes ausführen.

   • Der Treiber konfiguriert die Adapterhardware basierend auf den standardisierten Schlüsselworteinstellungen des NIC-Switches. Basierend auf diesen Einstellungen weist der Treiber die erforderlichen Hardware- und Softwareressourcen für den NIC-Switch zu.

   • Der Miniporttreiber ruft NdisMEnableVirtualization auf, um SR-IOV zu aktivieren und die Anzahl der VFs auf dem Netzwerkadapter festzulegen. Diese Funktion konfiguriert die SR-IOV Extended Capability im PCI-Konfigurationsraum des Adapters. Wenn diese Funktion NDIS_STATUS_SUCCESS zurückgibt, ist SR-IOV aktiviert, und die VFs werden über die PCIe-Schnittstelle verfügbar gemacht.

   Weitere Informationen finden Sie unter Statische Erstellung eines NIC-Switches.

   Anmerkung Wenn der Miniporttreiber die Erstellung dynamischer NIC-Switches unterstützt, erstellt er den Switch und aktiviert die Virtualisierung, wenn er eine OID-Methodenanforderung (Object Identifier) von OID_NIC_SWITCH_CREATE_SWITCH verarbeitet. Weitere Informationen finden Sie unter dynamische Erstellung eines NIC Switch.