NDIS_STATUS_SWITCH_PORT_REMOVE_VF
De NDIS_STATUS_SWITCH_PORT_REMOVE_VF statusaanduiding wordt uitgegeven door een Hyper-V uitbreidbare switch forwarding-extensie om de binding tussen een virtuele machine (VM)-netwerkadapter en een virtuele PCI Express -functie (PCIe) (VF) te verwijderen. De VF wordt weergegeven en ondersteund door een onderliggende fysieke netwerkadapter die ondersteuning biedt voor de I/O-interface met één hoofdmap (SR-IOV).
Als u de NDIS_STATUS_SWITCH_PORT_REMOVE_VF statusindicatie wilt uitgeven, moet de doorstuurextensie de aanduiding in een NDIS_SWITCH_NIC_STATUS_INDICATION structuur inkapselen en een NDIS_STATUS_SWITCH_NIC_STATUS statusindicatie uitgeven.
Zie Richtlijnen voor het uitgeven van een NDIS_STATUS_SWITCH_PORT_REMOVE_VF statusaanduidingvoor meer informatie over dit proces.
Opmerkingen
Er wordt een PCIe-VF gemaakt en toegewezen door een onderliggende fysieke adapter die ondersteuning biedt voor de SR-IOV-interface. Zodra de virtualisatiestack is gemaakt, koppelt of , wordt de VF gekoppeld aan een Hyper-V onderliggende partitie. Het gastbesturingssysteem dat in deze partitie wordt uitgevoerd, maakt een virtuele machine (VM)-netwerkadapter beschikbaar die is gebonden aan de VF van de onderliggende SR-IOV fysieke adapter.
Nadat de virtuele en fysieke netwerkadapters zijn toegewezen, worden pakketten rechtstreeks gerouteerd tussen de VF en de VM-netwerkadapter. Omdat de uitbreidbare switch echter niet betrokken is bij pakketlevering, worden uitbreidbare switchpoortbeleidsregels niet toegepast op deze pakketten. Dit omvat poortbeleid voor toegangsbeheerlijsten (ACL's) en quality of service (QoS).
Een uitbreidbare switch forwarding-extensie kan de toewijzing van de VF aan de onderliggende partitie verwijderen door een NDIS_STATUS_SWITCH_PORT_REMOVE_VF statusindicatie uit te geven. Deze indicatie zorgt ervoor dat de pakketten worden geleverd via een uitbreidbare switchpoort in plaats van rechtstreeks tussen de VM-netwerkadapter en de VF van de onderliggende SR-IOV fysieke adapter. Hierdoor kan het uitbreidbare poortbeleid worden toegepast op pakketten die worden ontvangen of verzonden via de uitbreidbare switchpoort.
Wanneer de doorstuurextensie de NDIS_STATUS_SWITCH_PORT_REMOVE_VF statusindicatie maakt, wordt de uitbreidbare switchpoort opgegeven waarmee de VM-netwerkadapter is verbonden.
Zie Forwarding Extensionsvoor meer informatie over uitbreidbare uitbreidingen voor doorsturen.
richtlijnen voor het uitgeven van een NDIS_STATUS_SWITCH_PORT_REMOVE_VF statusindicatie
Als u de NDIS_STATUS_SWITCH_PORT_REMOVE_VF statusindicatie wilt uitgeven, moet de doorstuurextensie de volgende stappen uitvoeren:
De doorstuurextensie initialiseert een NDIS_STATUS_INDICATION structuur voor de NDIS_STATUS_SWITCH_PORT_REMOVE_VF indicatie. Voor deze indicatie worden met de doorstuuruitbreidingen de volgende leden van de NDIS_STATUS_INDICATION structuur ingesteld:
De StatusCode lid moet worden ingesteld op NDIS_STATUS_SWITCH_PORT_REMOVE_VF.
Het StatusBuffer- lid moet worden ingesteld op NULL-.
De StatusBufferSize- moet worden ingesteld op nul.
De doorstuurextensie initialiseert een NDIS_SWITCH_NIC_STATUS_INDICATION structuur. Als u een VF-toewijzing wilt verwijderen, moet de doorstuurextensie de leden op de volgende manier instellen:
Het DestinationPortId lid moet worden ingesteld op de id van een uitbreidbare switchpoort waarmee de VM-netwerkadapter is verbonden.
De DestinationNicIndex lid moet worden ingesteld op de indexwaarde van de VM-netwerkadapter die is verbonden met de opgegeven poort.
Het SourcePortId lid moet zijn ingesteld op NDIS_SWITCH_DEFAULT_PORT_ID.
Het SourceNicIndex- lid moet zijn ingesteld op NDIS_SWITCH_DEFAULT_NIC_INDEX.
De statusindicatie lid moet worden ingesteld op het adres van de NDIS_STATUS_INDICATION structuur voor de NDIS_STATUS_SWITCH_PORT_REMOVE_VF indicatie.
De doorstuurextensie initialiseert een NDIS_STATUS_INDICATION structuur voor de NDIS_SWITCH_NIC_STATUS_INDICATION indicatie. Voor deze indicatie stelt de doorstuuruitbreiding de volgende leden van de NDIS_STATUS_INDICATION-structuur in:
De StatusCode lid moet worden ingesteld op NDIS_STATUS_SWITCH_NIC_STATUS.
Het StatusBuffer- lid moet worden ingesteld op het adres van de NDIS_SWITCH_NIC_STATUS_INDICATION-structuur.
De StatusBufferSize- moet worden ingesteld op de lengte, in bytes, van de NDIS_SWITCH_NIC_STATUS_INDICATION structuur en de NDIS_STATUS_INDICATION structuur voor de NDIS_STATUS_SWITCH_PORT_REMOVE_VF indicatie.
De doorstuurextensie moet ReferenceSwitchNic aanroepen om een referentiemeteritem voor de VM-netwerkadapter te verhogen. Als ReferenceSwitchNic- niet is voltooid met NDIS_STATUS_SUCCESS, mag de doorstuurextensie de statusindicatie niet doorsturen.
Opmerking Als de doorstuurextensie een OID_SWITCH_NIC_DISCONNECT-setaanvraag voor de VM-adapter heeft ontvangen, mag deze geen ReferenceSwitchNic- aanroepen of de statusindicatie doorsturen.
De doorstuurextensie roept NdisFIndicateStatus aan om de NDIS_STATUS_INDICATION door te sturen naar extensies in de uitbreidbare stuurprogrammastack. Wanneer de doorstuurextensie deze functie aanroept, wordt de parameter StatusIndication ingesteld op een aanwijzer op de NDIS_STATUS_INDICATION structuur voor de NDIS_STATUS_SWITCH_NIC_STATUS indicatie.
Nadat NdisFIndicateStatus retourneert, moet de doorstuurextensie DereferenceSwitchNic aanroepen om de referentieteller voor de VM-netwerkadapter te verlagen.
Opmerking De doorstuurextensie moet de vorige stappen volgen voor elke VF-toewijzing die door de doorstuurextensie wordt verwijderd.
Zie Statusindicaties van filtermodulesvoor meer informatie over hoe een doorstuurextensie statusindicaties doorstuurt.
Richtlijnen voor het bepalen van VF-toewijzingen
De doorstuurextensie kan de huidige VF-toewijzingen voor virtuele netwerkadapters inventariseren door een OID-queryaanvraag van OID_SWITCH_NIC_ARRAYuit te geven. Deze aanvraag retourneert een NDIS_SWITCH_NIC_ARRAY structuur die een matrix van NDIS_SWITCH_NIC_PARAMETERS structuren bevat. Elke NDIS_SWITCH_NIC_PARAMETERS structuur geeft de parameters op van een netwerkadapter die wordt weergegeven in een van de volgende omgevingen:
Het beheerbesturingssysteem dat wordt uitgevoerd in de bovenliggende partitie Hyper-V.
Netwerkadapters die in dit besturingssysteem worden weergegeven, worden opgegeven met een NDIS_SWITCH_NIC_TYPE opsommingswaarde van NdisSwitchNicTypeExternal of NdisSwitchNicTypeInternal.
Het gastbesturingssysteem dat wordt uitgevoerd in een Hyper-V onderliggende partitie.
Netwerkadapters die in dit besturingssysteem worden weergegeven, worden opgegeven met een NDIS_SWITCH_NIC_TYPE opsommingswaarde van NdisSwitchNicTypeSynthetische of NdisSwitchNicTypeEmulated.
Als de OID-queryaanvraag van OID_SWITCH_NIC_ARRAY is voltooid met een status van NDIS_STATUS_SUCCESS, kan de doorstuurextensie VF-toewijzingen bepalen door elke NDIS_SWITCH_NIC_PARAMETERS structuur in de geretourneerde matrix te controleren. Als de VFAssigned lid van de NDIS_SWITCH_NIC_PARAMETERS structuur is ingesteld op TRUE, wordt de netwerkadapter die overeenkomt met de NDIS_SWITCH_NIC_PARAMETERS structuur toegewezen aan een VF.
De doorstuurextensie kan de toewijzing verwijderen door een NDIS_STATUS_SWITCH_PORT_REMOVE_VF statusindicatie uit te geven. In dit geval moet de doorstuurextensie het DestinationPortId- lid van de NDIS_SWITCH_NIC_STATUS_INDICATION instellen op de waarde van de PortId lid van de NDIS_SWITCH_NIC_PARAMETERS-structuur.
Zie Richtlijnen voor het uitgeven van een NDIS_STATUS_SWITCH_PORT_REMOVE_VF statusindicatievoor meer informatie over het uitgeven van een NDIS_STATUS_SWITCH_PORT_REMOVE_VF statusindicatie.
Eisen
Versie |
Ondersteund in NDIS 6.30 en hoger. |
Rubriek |
Ndis.h (inclusief Ndis.h) |