OID_SWITCH_NIC_DISCONNECT

Artikel
03/13/2025

Protokollgränsen för den Hyper-V utökningsbara växeln utfärdar en begäran om objektidentifierare (OID) för OID_SWITCH_NIC_DISCONNECT för att meddela underliggande utökningsbara växeltillägg att en anslutning mellan en utökningsbar växelport och ett nätverkskort bryts. När anslutningen är helt ur funktion utfärdar protokollgränsen för den utökningsbara växeln en OID-uppsättningsbegäran för OID_SWITCH_NIC_DELETE.

InformationBuffer medlem i NDIS_OID_REQUEST struktur innehåller en pekare till en NDIS_SWITCH_NIC_PARAMETERS struktur.

Anmärkningar

Index- medlem i NDIS_SWITCH_NIC_PARAMETERS-strukturen anger indexet för ett nätverkskort som frånkopplingsmeddelandet görs för. Nätverkskortet med det angivna Index-värdet är anslutet till den utökningsbara växelport som anges av PortId-medlemmen. Mer information om dessa indexvärden finns i Indexvärden för nätverkskort.

Tillägget måste följa dessa riktlinjer när det hanterar OID-uppsättningsbegäranden för OID_SWITCH_NIC_DISCONNECT:

Tillägget får inte ändra den NDIS_SWITCH_NIC_PARAMETERS struktur som är associerad med OID-begäran.
Den OID_SWITCH_NIC_DISCONNECT begäran meddelar endast tillägget att den utökningsbara växelanslutningen bryts mellan det angivna nätverkskortet och utökningsbar växelport. När tillägget har hanterat den här OID-begäran får den inte göra följande:
- Generera eventuell pakettrafik till nätverkskortanslutningen på den utökningsbara växelport som OID_SWITCH_NIC_DISCONNECT OID-begäran utfärdades för.
- Anropa ReferenceSwitchNic för att öka den utökningsbara växelreferensräknaren för den angivna nätverkskortanslutningen på den utökningsbara växelporten.
- Vidarebefordra eller påbörja OID-begäranden om OID_SWITCH_NIC_REQUEST till ett underliggande nätverkskort som OID_SWITCH_NIC_DISCONNECT OID-begäran utfärdades för.
  
  Obs Om tillägget med namnet ReferenceSwitchNic att öka den utökningsbara växelreferensräknaren innan OID_SWITCH_NIC_DISCONNECT utfärdas, kan tillägget fortfarande vidarebefordra eller komma från OID-begäranden.
- Vidarebefordra eller härstammar från NDIS-statusindikationer för NDIS_STATUS_SWITCH_NIC_STATUS från ett underliggande nätverkskort som OID_SWITCH_NIC_DISCONNECT OID-begäran utfärdades för.
  
  Obs Om tillägget med namnet ReferenceSwitchNic att öka den utökningsbara växelreferensräknaren innan OID_SWITCH_NIC_DISCONNECT utfärdas, kan tillägget fortfarande vidarebefordra eller komma från NDIS-statusbeteckningar.
  
  Obs Om tillägget som tidigare kallades ReferenceSwitchNic för att öka den utökningsbara växelreferensräknaren behöver det inte synkronisera sina anrop för att komma från eller vidarebefordra OID-begäranden eller NDIS-statusbeteckningar med sin kod som hanterar Hyper-V utökningsbara växelns OID-begäranden. När tillägget har ökat referensräknaren utfärdar det utökningsbara växelgränssnittet inte en OID-uppsättningsbegäran för OID_SWITCH_NIC_DELETE.
Tillägget måste alltid vidarebefordra denna OID-uppsättningsbegäran till underliggande tillägg. Tillägget får inte slutföra begäran.
Det utökningsbara växelns externa nätverkskort kan binda till ett eller flera underliggande fysiska kort. För varje fysiskt nätverkskort som är bundet till det externa nätverkskortet utfärdar protokollgränsen för den utökningsbara växeln en separat OID-uppsättningsbegäran för OID_SWITCH_NIC_DISCONNECT. Varje OID-uppsättningsbegäran anger ett annat indexvärde för nätverkskortanslutning. Mer information om dessa indexvärden finns i Indexvärden för nätverkskort.

Tillägget måste behålla anslutningstillståndet för varje underliggande fysiskt kort. Mer information om de olika konfigurationer där fysiska nätverkskort kan bindas till det externa nätverkskortet finns i typer av konfigurationer av fysiska nätverkskort.

Obs Tillägget får inte utfärda sina egna OID-uppsättningsbegäranden för OID_SWITCH_NIC_DISCONNECT.

Mer information om tillstånd för utökningsbara växelportar och nätverkskortanslutningar finns i Hyper-V Extensible Switch Port and Network Adapter States.

Returstatuskoder

Den underliggande miniportgränsen för den utökningsbara växeln slutför OID-frågebegäran för OID_SWITCH_NIC_DISCONNECT och returnerar följande statuskod.