NDIS_STATUS_SWITCH_PORT_REMOVE_VF

Artikel
03/13/2025

Statusindikeringen NDIS_STATUS_SWITCH_PORT_REMOVE_VF utfärdas av ett Hyper-V utökningsbart tillägg för vidarekoppling för att ta bort bindningen mellan ett virtuellt datornätverkskort (VM) och en virtuell PCI Express-funktion (PCIe). Den virtuella hårddisken exponeras och stöds av ett underliggande fysiskt nätverkskort som stöder det enda rot-I/O-virtualiseringsgränssnittet (SR-IOV).

För att kunna utfärda statusindikatorn för NDIS_STATUS_SWITCH_PORT_REMOVE_VF måste vidarebefordringstillägget kapsla in indikationen i en NDIS_SWITCH_NIC_STATUS_INDICATION struktur och utfärda en NDIS_STATUS_SWITCH_NIC_STATUS statusindikator.

Mer information om den här processen finns i Riktlinjer för utfärdande av en NDIS_STATUS_SWITCH_PORT_REMOVE_VF statusindikator.

Anmärkningar

En PCIe VF skapas och allokeras av ett underliggande fysiskt kort som stöder SR-IOV-gränssnittet. När den har skapats kopplas virtualiseringsstacken eller tilldelar, VF till en Hyper-V underordnad partition. Gästoperativsystemet som körs i den här partitionen exponerar ett virtuellt datornätverkskort (VM) som är bundet till den virtuella hårddisken för den underliggande SR-IOV fysiska adaptern.

När de virtuella och fysiska nätverkskorten har tilldelats dirigeras paketen direkt mellan den virtuella hårddisken och det virtuella datornätverkskortet. Men eftersom den utökningsbara växeln inte ingår i paketleveransen tillämpas inte utökningsbara växelportprinciper på dessa paket. Detta inkluderar portprinciper för åtkomstkontrollistor (ACL) och tjänstkvalitet (QoS).

En utökningsbar växelvidarebefordringstillägg kan ta bort tilldelningen av den virtuella hårddisken till den underordnade partitionen genom att utfärda en NDIS_STATUS_SWITCH_PORT_REMOVE_VF statusindikering. Den här indikationen gör att paketen levereras via en utökningsbar växelport i stället för direkt mellan det virtuella datornätverkskortet och VF för den underliggande SR-IOV fysiska adaptern. På så sätt kan utökningsbara växelportprinciper tillämpas på paket som tas emot eller skickas via den utökningsbara växelporten.

När vidarebefordran av tillägget gör NDIS_STATUS_SWITCH_PORT_REMOVE_VF statusindikering anger det den utökningsbara växelport som det virtuella datornätverkskortet är anslutet till.

Mer information om utökningsbara tillägg för vidarekoppling finns i Vidarebefordringstillägg.

riktlinjer för utfärdande av en NDIS_STATUS_SWITCH_PORT_REMOVE_VF statusindikator

För att kunna utfärda statusindikatorn för NDIS_STATUS_SWITCH_PORT_REMOVE_VF måste vidarebefordringstillägget följa dessa steg:

Vidarebefordringstillägget initierar en NDIS_STATUS_INDICATION struktur för NDIS_STATUS_SWITCH_PORT_REMOVE_VF-indikationen. För den här indikationen anger vidarebefordran tilläggen följande medlemmar i den NDIS_STATUS_INDICATION strukturen:
- StatusCode- medlem måste anges till NDIS_STATUS_SWITCH_PORT_REMOVE_VF.
- StatusBuffer-medlemmen måste anges till NULL-.
- StatusBufferSize- måste anges till noll.
Vidarebefordringstillägget initierar en NDIS_SWITCH_NIC_STATUS_INDICATION struktur. För att kunna ta bort en VF-tilldelning måste vidarebefordringstillägget ange medlemmarna på följande sätt:
- DestinationPortId medlem måste anges till identifieraren för en utökningsbar växelport som det virtuella datornätverkskortet är anslutet till.
- DestinationNicIndex medlem måste anges till indexvärdet för det virtuella datornätverkskortet som är anslutet till den angivna porten.
- Medlemmen SourcePortId måste vara inställd på NDIS_SWITCH_DEFAULT_PORT_ID.
- Medlemmen SourceNicIndex måste vara inställd på NDIS_SWITCH_DEFAULT_NIC_INDEX.
- StatusIndication medlem måste anges till adressen för NDIS_STATUS_INDICATION struktur för NDIS_STATUS_SWITCH_PORT_REMOVE_VF-indikationen.
Vidarebefordringstillägget initierar en NDIS_STATUS_INDICATION struktur för NDIS_SWITCH_NIC_STATUS_INDICATION-indikationen. För den här indikationen anger vidarebefordringstillägget följande medlemmar i NDIS_STATUS_INDICATION-strukturen:
- StatusCode-medlemmen måste anges till NDIS_STATUS_SWITCH_NIC_STATUS.
- StatusBuffer medlem måste anges till adressen för den NDIS_SWITCH_NIC_STATUS_INDICATION strukturen.
- StatusBufferSize- måste anges till längden, i byte, på NDIS_SWITCH_NIC_STATUS_INDICATION struktur och NDIS_STATUS_INDICATION struktur för NDIS_STATUS_SWITCH_PORT_REMOVE_VF-indikationen.
Vidarebefordringstillägget måste anropa ReferenceSwitchNic för att öka en referensräknare för det virtuella datornätverkskortet. Om ReferenceSwitchNic inte slutförs med NDIS_STATUS_SUCCESS får vidarebefordran inte vidarebefordra statusindikatorn.

Obs Om vidarebefordran har tagit emot en OID_SWITCH_NIC_DISCONNECT inställd begäran för det virtuella datorkortet får den inte anropa ReferenceSwitchNic eller vidarebefordra statusindikeringen.
Vidarebefordringstillägget anropar NdisFIndicateStatus för att vidarebefordra NDIS_STATUS_INDICATION till överliggande tillägg i den utökningsbara växeldrivrutinsstacken. När vidarebefordringstillägget anropar den här funktionen anger den parametern StatusIndication till en pekare till NDIS_STATUS_INDICATION struktur för NDIS_STATUS_SWITCH_NIC_STATUS-indikationen.
När NdisFIndicateStatus returnerar måste vidarebefordran anropa DereferenceSwitchNic för att minska referensräknaren för det virtuella datornätverkskortet.

Obs Vidarebefordringstillägget måste följa föregående steg för varje VF-tilldelning som vidarebefordringstillägget tar bort.

Mer information om hur ett vidarebefordrande tillägg vidarebefordrar statusinformation finns i Filter Module Status Indications.

Riktlinjer för att fastställa VF-tilldelningar

Vidarebefordringstillägget kan räkna upp aktuella VF-tilldelningar för virtuella nätverkskort genom att utfärda en OID-frågebegäran för OID_SWITCH_NIC_ARRAY. Den här begäran returnerar en NDIS_SWITCH_NIC_ARRAY struktur som innehåller en matris med NDIS_SWITCH_NIC_PARAMETERS strukturer. Varje NDIS_SWITCH_NIC_PARAMETERS struktur anger parametrarna för ett nätverkskort som exponeras i någon av följande miljöer:

Hanteringsoperativsystemet som körs i den Hyper-V överordnade partitionen.

Nätverkskort som exponeras i det här operativsystemet anges med ett NDIS_SWITCH_NIC_TYPE uppräkningsvärde för NdisSwitchNicTypeExternal eller NdisSwitchNicTypeInternal.
Gästoperativsystemet som körs i en Hyper-V underordnad partition.

Nätverkskort som exponeras i det här operativsystemet anges med ett NDIS_SWITCH_NIC_TYPE uppräkningsvärde för NdisSwitchNicTypeSynthetic eller NdisSwitchNicTypeEmulated.

Om OID-frågebegäran för OID_SWITCH_NIC_ARRAY slutförs med statusen NDIS_STATUS_SUCCESS kan vidarebefordran fastställa VF-tilldelningar genom att granska varje NDIS_SWITCH_NIC_PARAMETERS struktur i den returnerade matrisen. Om VFAssigned medlem i NDIS_SWITCH_NIC_PARAMETERS-strukturen är inställd på TRUEtilldelas nätverkskortet som motsvarar den NDIS_SWITCH_NIC_PARAMETERS strukturen till en virtuell hårddisk.

Vidarebefordringstillägget kan ta bort tilldelningen genom att utfärda en NDIS_STATUS_SWITCH_PORT_REMOVE_VF statusindikering. I det här fallet måste vidarebefordringstillägget ange DestinationPortId medlem i NDIS_SWITCH_NIC_STATUS_INDICATION till värdet för PortId medlem i NDIS_SWITCH_NIC_PARAMETERS-strukturen.

Mer information om hur du utfärdar en statusindikator för NDIS_STATUS_SWITCH_PORT_REMOVE_VF finns i Riktlinjer för att utfärda en NDIS_STATUS_SWITCH_PORT_REMOVE_VF statusindikator.