Mogelijkheden voor SR-IOV bepalen

In dit onderwerp wordt beschreven hoe NDIS en overliggende stuurprogramma's de mogelijkheden van enkele root I/O-virtualisatie (SR-IOV) van een netwerkadapter bepalen. Dit onderwerp bevat de volgende informatie:

Rapporteren van SR-IOV-mogelijkheden tijdens MiniportInitializeEx

Vragen naar SR-IOV-mogelijkheden door overliggende stuurprogramma's

Rapporteren van SR-IOV-mogelijkheden tijdens MiniportInitializeEx

Wanneer NDIS de miniportstuurprogramma's MiniportInitializeEx-functie aanroept, biedt het stuurprogramma de volgende SR-IOV mogelijkheden:

• De volledige set SR-IOV hardwaremogelijkheden die de netwerkadapter kan ondersteunen.

• De SR-IOV mogelijkheden die momenteel zijn ingeschakeld op de netwerkadapter.

• Of het minipoortstuurprogramma de fysieke functie (PF) of virtuele functie (VF) van PCI Express (PCIe) op de netwerkadapter beheert.

Het minipoortstuurprogramma rapporteert de SR-IOV hardwaremogelijkheden van de onderliggende netwerkadapter via een NDIS_SRIOV_CAPABILITIES structuur die op de volgende manier wordt geïnitialiseerd:

1. Het minipoortstuurprogramma initialiseert het Header lid. Het stuurprogramma stelt het Type element van Header in op NDIS_OBJECT_TYPE_DEFAULT.

   Vanaf NDIS 6.30 stelt het minipoortstuurprogramma het revisielid van header in op NDIS_SRIOV_CAPABILITIES _REVISION_1 en het lid Grootte op NDIS_SIZEOF_SRIOV_CAPABILITIES_REVISION_1.

2. Het minipoortstuurprogramma stelt de juiste vlaggen in het lid SriovCapabilities in om de SR-IOV mogelijkheden te rapporteren.

   Als de netwerkadapter SR-IOV ondersteunt, moet het minipoortstuurprogramma voor de fysieke functie VAN PCI Express (PCIe) van de adapter de volgende vlaggen instellen:

   • NDIS_SRIOV_CAPS_SRIOV_SUPPORTED

   • NDIS_SRIOV_CAPS_PF_MINIPORT

   Opmerking

    Het minipoortstuurprogramma voor een virtuele PCIe-functie (VF) van de netwerkadapter moet zowel de vlag NDIS_SRIOV_CAPS_VF_MINIPORT als de vlag NDIS_SRIOV_CAPS_SRIOV_SUPPORTED instellen.  

Wanneer NDIS de Miniport Driver's MiniportInitializeEx-functie aanroept, registreert het stuurprogramma de SR-IOV mogelijkheden van de netwerkadapter door de volgende stappen uit te voeren:

1. Het minipoortstuurprogramma initializeert een NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES structuur.

   Het minipoortstuurprogramma stelt het lid HardwareSriovCapabilities in op een aanwijzer naar de eerder geïnitialiseerde NDIS_SRIOV_CAPABILITIES structuur.

   Als de registerinstelling voor het trefwoord *SRIOV INF een waarde heeft, zijn de SR-IOV mogelijkheden momenteel ingeschakeld op de netwerkadapter. Het minipoortstuurprogramma stelt de leden van CurrentSriovCapabilities in op een aanwijzer naar dezelfde NDIS_SRIOV_CAPABILITIES structuur.

   Als de registerinstelling voor het trefwoord *SRIOV INF de waarde nul heeft, worden de SR-IOV mogelijkheden momenteel uitgeschakeld op de netwerkadapter. Het minipoortstuurprogramma moet het lid CurrentSriovCapabilities instellen op NULL.

   Zie voor meer informatie over het trefwoord *SRIOV INF Gestandaardiseerde INF-trefwoorden voor SR-IOV-.

2. Het stuurprogramma roept NdisMSetMiniportAttributes aan en stelt de parameter MiniportAttributes in op een aanwijzer naar de NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES-structuur.

Zie Initialiseren van een minipoortadaptervoor meer informatie over het initialisatieproces van de adapter.

Queries uitvoeren van SR-IOV-mogelijkheden door bovenliggende stuurprogramma's

NDIS geeft de momenteel ingeschakelde SR-IOV mogelijkheden van de netwerkadapter door aan overliggende stuurprogramma's die op de volgende manier aan de netwerkadapter binden:

• Wanneer NDIS de functie FilterAttach van het filterstuurprogramma aanroept, geeft NDIS de SR-IOV mogelijkheden van de netwerkadapter door via de parameter AttachParameters . Deze parameter bevat een aanwijzer naar een NDIS_FILTER_ATTACH_PARAMETERS structuur. Het lid SriovCapabilities van deze structuur bevat een aanwijzer naar een NDIS_SRIOV_CAPABILITIES structuur.

• Wanneer NDIS de functie ProtocolBindAdapterEx van het protocolstuurprogramma aanroept, geeft NDIS de SR-IOV mogelijkheden van de netwerkadapter door via de parameter BindParameters . Deze parameter bevat een aanwijzer naar een NDIS_FILTER_ATTACH_PARAMETERS structuur. Het lid SriovCapabilities van deze structuur bevat een aanwijzer naar een NDIS_SRIOV_CAPABILITIES structuur.

NDIS retourneert ook de NDIS_SRIOV_CAPABILITIES structuur bij het verwerken van object-id (OID) query aanvragen van OID_SRIOV_HARDWARE_CAPABILITIES en OID_SRIOV_CURRENT_CAPABILITIES die worden uitgegeven door overliggende protocol- of filterstuurprogramma's.