Freigeben über

MiniportAddDevice Guidelines for PF Miniport Drivers

  • Artikel

In diesem Thema werden die Richtlinien zum Schreiben einer MiniportAddDevice-Funktion für den Miniporttreiber der PCI Express (PCIe) Physical Function (PF) beschrieben. Die PF ist eine Komponente eines Netzwerkadapters, der die Single-Root-E/A-Virtualisierung (Single Root I/O Virtualization, SR-IOV) unterstützt.

Hinweis 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-Miniporttreibers.

Der Plug & Play -Manager (PnP) ruft die NDIS-Funktion AddDevice auf, um das funktionale Geräteobjekt (Functional Device Object, FDO) für den Netzwerkadapter zu erstellen. Wenn der PF-Miniporttreiber einen MiniportAddDevice-Einstiegspunkt registriert hat , wenn er NdisMRegisterMiniportDriver aufgerufen hat, ruft NDIS die MiniportAddDevice-Funktion des Treibers auf.

Wenn MiniportAddDevice aufgerufen wird, kann der PF-Miniporttreiber zusätzliche Softwareressourcen für den SR-IOV und die Netzwerkschnittstelle Karte -Switch (NIC) zuweisen. In der Regel sind dies Ressourcen, die zugeordnet werden müssen, bevor NDIS die MiniportInitializeEx-Funktion des Treibers aufruft.

Der Treiber kann folgendes im Kontext des Aufrufs von MiniportAddDevice ausführen:

  • Der PF-Miniporttreiber kann NdisReadConfiguration aufrufen, um die Konfigurationseinstellungen des SR-IOV- und NIC-Switches aus der Registrierung zu lesen. Diese Konfigurationseinstellungen werden durch die standardisierten SR-IOV-Schlüsselwörter definiert. Weitere Informationen zu diesen Schlüsselwörtern finden Sie unter Standardisierte INF-Schlüsselwörter für SR-IOV.

  • Basierend auf diesen Konfigurationseinstellungen weist der PF-Miniporttreiber die zusätzlichen Softwareressourcen für den SR-IOV-Netzwerkadapter zu.

Hinweis Die tatsächliche Zuordnung von Hardwareressourcen und die Aktivierung von SR-IOV im PCI-Konfigurationsraum dürfen nur im Kontext des Aufrufs von MiniportInitializeEx erfolgen. Da der Speicher zugeordnete E/A-Speicherplatz (MMIO) des Netzwerkadapters beim Aufruf von MiniportAddDevice nicht initialisiert wird, darf der Miniporttreiber den Adapter erst lesen oder schreiben, wenn MiniportInitializeEx aufgerufen wird.