Delen via


OID_SWITCH_PORT_DELETE

De protocolrand van de Hyper-V uitbreidbare switch geeft een OID-setaanvraag (Object Identifier) van OID_SWITCH_PORT_DELETE om uitbreidbare switchextensies op de hoogte te stellen van het verwijderen van een uitbreidbare switchpoort.

De InformationBuffer lid van de NDIS_OID_REQUEST-structuur bevat een aanwijzer naar een NDIS_SWITCH_PORT_PARAMETERS structuur.

Opmerkingen

De PortId lid van de NDIS_SWITCH_PORT_PARAMETERS-structuur geeft de uitbreidbare switchpoort op waarvoor de verwijdermelding wordt uitgevoerd.

Als een netwerkadapter is verbonden met de opgegeven poort, wordt de verbinding door de protocolrand van de uitbreidbare switch verwijderd voordat de poort wordt verwijderd. In dit geval volgt de protocolrand deze stappen voordat de poort wordt verwijderd:

  • De protocolrand geeft een OID-setaanvraag van OID_SWITCH_NIC_DISCONNECT om de extensie op de hoogte te stellen dat de verbinding tussen een netwerkadapter en de uitbreidbare switchpoort wordt verwijderd.

  • Nadat alle in behandeling zijnde pakketten voor de opgegeven uitbreidbare switchpoort zijn geannuleerd of voltooid, geeft de protocolrand een OID-setaanvraag van OID_SWITCH_NIC_DELETE uit om de extensie op de hoogte te stellen dat de verbinding tussen een netwerkadapter en de uitbreidbare switchpoort is verwijderd.

    Op dit moment kan de protocolrand beginnen met het verwijderen van de poort.

De protocolrand van de uitbreidbare switch volgt deze stappen wanneer een uitbreidbare switchpoort wordt verwijderd:

  1. De protocolrand van de uitbreidbare switch geeft een OID-setaanvraag van OID_SWITCH_PORT_TEARDOWN. Deze OID-aanvraag meldt onderliggende uitbreidbare switchextensies over het begin van het verwijderingsproces voor een uitbreidbare switchpoort.

  2. De protocolrand geeft een OID-setaanvraag van OID_SWITCH_PORT_DELETE nadat alle OID-aanvragen voor de uitbreidbare switchpoort zijn voltooid.

    Opmerking Als de extensie eerder ReferenceSwitchPort had aangeroepen om het referentiemeteritem van de poort te verhogen, moet deze DereferenceSwitchPort aanroepen voordat de protocolrand de OID_SWITCH_NIC_DELETE aanvraag uitgeeft.

De extensie moet voldoen aan deze richtlijnen voor het verwerken van OID-setaanvragen van OID_SWITCH_PORT_DELETE:

  • De extensie mag de NDIS_SWITCH_PORT_PARAMETERS structuur die is gekoppeld aan de OID-aanvraag niet wijzigen.

  • De extensie moet deze OID-setaanvraag altijd doorsturen naar onderliggende extensies. De extensie mag de aanvraag niet mislukken.

  • Nadat de OID_SWITCH_PORT_DELETE-aanvraag is voltooid met NDIS_STATUS_SUCCESS, ontvangt de extensie geen pakketten of OID-aanvragen voor de verwijderde poort. De extensie kan geen pakketten doorsturen naar de verwijderde poort. De extensie kan ook geen OID-aanvragen uitgeven of de ReferenceSwitchPort--functie aanroepen voor de verwijderde poort.

Opmerking Uitbreidingen voor uitbreidbare switch mogen geen OID-setaanvragen van OID_SWITCH_PORT_DELETE uitgeven.

Zie Hyper-V Uitbreidbare switchpoorten en netwerkadapterstatussenvoor meer informatie over de statussen van uitbreidbare switchpoorten en netwerkadapterverbindingen.

Statuscodes retourneren

De onderliggende minipoortrand van de uitbreidbare switch voltooit de OID-setaanvraag van OID_SWITCH_PORT_DELETE en retourneert de volgende statuscode.

Statuscode Beschrijving

NDIS_STATUS_SUCCESS

De OID-aanvraag is voltooid.

Eisen

Versie

Ondersteund in NDIS 6.30 en hoger.

Rubriek

Ntddndis.h (inclusief Ndis.h)

Zie ook


DereferenceSwitchPort

NDIS_OID_REQUEST

NDIS_SWITCH_PORT_PARAMETERS

NdisFOidRequest

OID_SWITCH_NIC_DELETE

OID_SWITCH_PORT_ARRAY

ReferenceSwitchPort-