OID_SWITCH_NIC_CREATE
De protocolrand van de Hyper-V uitbreidbare switch geeft een OID-setaanvraag (object-id) van OID_SWITCH_NIC_CREATE om onderliggende uitbreidbare switchextensies op de hoogte te stellen dat er een nieuwe verbinding tot stand wordt gebracht tussen een uitbreidbare switchpoort en een externe of virtuele netwerkadapter. Nadat de verbinding volledig tot stand is gebracht, geeft de protocolrand van de uitbreidbare switch een OID-setaanvraag van OID_SWITCH_NIC_CONNECTuit.
De InformationBuffer lid van de NDIS_OID_REQUEST-structuur bevat een aanwijzer naar een NDIS_SWITCH_NIC_PARAMETERS structuur.
Opmerkingen
De PortId lid van de NDIS_SWITCH_NIC_PARAMETERS structuur geeft de uitbreidbare switchpoort op waarvoor de aanmaakmelding wordt gemaakt. De uitbreidbare switchextensie kan de parameterinformatie voor deze en andere poorten op de uitbreidbare switch verkrijgen door OID-queryaanvragen van OID_SWITCH_PORT_ARRAYuit te geven.
De Index lid van de NDIS_SWITCH_NIC_PARAMETERS structuur geeft de index op van een netwerkadapter waarvoor de aanmaakmelding wordt gemaakt. De netwerkadapter met de opgegeven Index-waarde is verbonden met de uitbreidbare switchpoort die is opgegeven door het PortId lid. Zie Network Adapter Index Valuesvoor meer informatie over deze indexwaarden.
Wanneer de OID-setaanvraag van OID_SWITCH_NIC_CREATE wordt ontvangen, moet de extensie de volgende richtlijnen volgen:
De extensie mag de NDIS_SWITCH_NIC_PARAMETERS structuur die is gekoppeld aan de OID-aanvraag niet wijzigen.
De OID_SWITCH_NIC_CREATE aanvraag meldt alleen de extensie dat er een nieuwe uitbreidbare switchverbinding wordt gegenereerd en dat pakketverkeer binnenkort via de opgegeven poort kan beginnen. De extensie kan de poort echter niet gebruiken totdat de protocolrand van de uitbreidbare switch een OID-setaanvraag van OID_SWITCH_NIC_CONNECTuitgeeft. Totdat die OID is uitgegeven, mag de extensie niet het volgende doen:
Genereer pakketverkeer naar de netwerkadapterverbinding op de uitbreidbare switchpoort waarvoor de OID_SWITCH_NIC_CREATE OID-aanvraag is uitgegeven.
Stuur OID-aanvragen van OID_SWITCH_NIC_REQUEST door naar een onderliggende netwerkadapter waarvoor de OID_SWITCH_NIC_CREATE OID-aanvraag is uitgegeven.
NDIS-statusindicaties doorsturen of afkomstig zijn van NDIS_STATUS_SWITCH_NIC_STATUS van een onderliggende netwerkadapter waarvoor de OID_SWITCH_NIC_CREATE OID-aanvraag is uitgegeven.
Roep ReferenceSwitchNic aan om de uitbreidbare switchreferentieteller voor de opgegeven netwerkadapterverbinding op de uitbreidbare switchpoort te verhogen.
Opmerking De extensie kan verzend- of ontvangstpakketten onderscheppen voor de opgegeven poort tussen de OID-aanvragen van OID_SWITCH_NIC_CREATE en OID_SWITCH_NIC_CONNECT. In dit geval moet de extensie de verzend- of ontvangstpakketaanvragen doorsturen in plaats van ze te annuleren.
De extensie kan de aanmaakmelding vetoeren door NDIS_STATUS_DATA_NOT_ACCEPTED voor de OID-aanvraag te retourneren. Als een extensie bijvoorbeeld niet kan voldoen aan het geconfigureerde beleid op de opgegeven poort, moet de extensie de melding voor het maken vetoenen.
Als de extensie andere NDIS_STATUS_Xxx statuscodes retourneert, wordt de aanmaakmelding ook vetoed. Het retourneren van statuscodes voor tijdelijke scenario's, zoals het retourneren van NDIS_STATUS_RESOURCES, kan echter leiden tot een nieuwe poging om de melding voor het maken te maken.
Als de extensie de OID-aanvraag niet vetoeert, moet deze de status controleren wanneer de aanvraag is voltooid. De extensie moet dit doen om te bepalen of de OID-aanvraag is vetoed door onderliggende extensies in het uitbreidbare switchbesturingselementpad of door de uitbreidbare switchinterface.
Opmerking De extensie kan de OID-aanvraag alleen vetoenen als de Index lid van de NDIS_SWITCH_NIC_PARAMETERS structuur een indexwaarde van de netwerkadapter van nul specificeert.
Als de extensie de melding voor het maken niet vetot, moet deze NdisFOidRequest aanroepen om deze OID-aanvraag door te sturen naar onderliggende extensies in de uitbreidbare stuurprogrammastack.
Opmerking De extensie moet de voltooiingsstatus van deze OID-aanvraag controleren. De extensie doet dit om te detecteren of onderliggende extensies in de uitbreidbare switchstuurprogrammastack de melding voor het maken veto hebben uitgevoerd.
Als de extensie NdisFOidRequest aanroept om deze OID-aanvraag door te sturen, ontvangt de extensie niet onmiddellijk pakketverkeer naar of van de uitbreidbare switchpoort. Bovendien kan de extensie geen verzend- of ontvangstverkeer direct injecteren voor de uitbreidbare switchpoort.
De extensie kan pakketverkeer alleen doorsturen naar de uitbreidbare switchpoort nadat de protocolrand van de uitbreidbare switch een OID-setaanvraag van OID_SWITCH_NIC_CONNECT.
Opmerking In sommige gevallen kan pakketverkeer worden doorgestuurd door de uitbreidbare switch naar de poort voordat een OID-setaanvraag van OID_SWITCH_NIC_CONNECT wordt uitgegeven.
De uitbreidbare switch externe netwerkadapter kan worden verbonden met een of meer onderliggende fysieke adapters. Voor elke fysieke netwerkadapter die is gebonden aan de externe netwerkadapter, geeft de protocolrand van de uitbreidbare switch een afzonderlijke OID-setaanvraag van OID_SWITCH_NIC_CREATE. Elke OID-setaanvraag geeft een andere indexwaarde voor de netwerkadapterverbinding op. Zie Network Adapter Index Valuesvoor meer informatie over deze indexwaarden.
De extensie moet de verbindingsstatus voor elke onderliggende fysieke adapter behouden. Zie Typen configuraties van fysieke netwerkadaptersvoor meer informatie over de verschillende configuraties waarin fysieke netwerkadapters kunnen worden gebonden aan de externe netwerkadapter.
Zie Hyper-V Uitbreidbare switchpoorten en netwerkadapterstatussenvoor meer informatie over de statussen van uitbreidbare switchpoorten en netwerkadapterverbindingen.
Opmerking De extensie mag geen eigen OID-setaanvragen van OID_SWITCH_NIC_CREATE uitgeven.
Statuscodes retourneren
Als de extensie de OID-setaanvraag van OID_SWITCH_NIC_CREATE voltooit, wordt een van de volgende statuscodes geretourneerd.
| Statuscode | Beschrijving |
|---|---|
NDIS_STATUS_DATA_NOT_ACCEPTED |
De extensie heeft de aanmaakmelding vetoeerd. |
NDIS_STATUS_RESOURCES |
De extensie heeft de aanmaakmelding vetoeerd vanwege een lage resourcevoorwaarde. |
NDIS_STATUS_Xxx- |
De uitbreiding heeft de aanmaakmelding om andere redenen vetoeerd. |
Opmerking Als de extensie de OID-setaanvraag voltooit, mag deze NDIS_STATUS_SUCCESS niet retourneren.
Als de extensie de OID-setaanvraag van OID_SWITCH_NIC_CREATE niet voltooit, wordt de aanvraag voltooid door de onderliggende minipoortrand van de uitbreidbare switch. De onderliggende minipoortrand retourneert de volgende statuscode voor deze OID-setaanvraag:
| 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) |