struttura NDIS_SWITCH_PORT_PROPERTY_VLAN (ntddndis.h)

Articolo
02/29/2024

La struttura NDIS_SWITCH_PORT_PROPERTY_VLAN specifica una proprietà dei criteri VLAN (Virtual Local Area Network) per una porta del commutatore estendibile Hyper-V.

Sintassi

typedef struct _NDIS_SWITCH_PORT_PROPERTY_VLAN {
  NDIS_OBJECT_HEADER         Header;
  ULONG                      Flags;
  NDIS_SWITCH_PORT_VLAN_MODE OperationMode;
  union {
    struct {
      UINT16 AccessVlanId;
      UINT16 NativeVlanId;
      UINT64 PruneVlanIdArray[64];
      UINT64 TrunkVlanIdArray[64];
    } VlanProperties;
    struct {
      NDIS_SWITCH_PORT_PVLAN_MODE PvlanMode;
      UINT16                      PrimaryVlanId;
      union {
        UINT16 SecondaryVlanId;
        UINT64 SecondaryVlanIdArray[64];
      };
    } PvlanProperties;
  };
} NDIS_SWITCH_PORT_PROPERTY_VLAN, *PNDIS_SWITCH_PORT_PROPERTY_VLAN;

Members

Header

Tipo, revisione e dimensioni della struttura NDIS_SWITCH_PORT_PROPERTY_VLAN . Questo membro viene formattato come struttura NDIS_OBJECT_HEADER .

Il membro Type di Header deve essere impostato su NDIS_OBJECT_TYPE_DEFAULT. Per specificare la versione della struttura NDIS_SWITCH_PORT_PROPERTY_VLAN , il membro Revision di Header deve essere impostato sul valore seguente:

NDIS_SWITCH_PORT_PROPERTY_VLAN_REVISION_1

Versione originale per NDIS 6.30 e versioni successive.

Impostare il membro Size su NDIS_SIZEOF_NDIS_SWITCH_PORT_PROPERTY_VLAN_REVISION_1.

Flags

Valore ULONG che contiene un OR bit per bit di flag. Questo membro è riservato per NDIS.

OperationMode

Valore di enumerazione NDIS_SWITCH_PORT_VLAN_MODE che specifica la modalità operativa della VLAN.

VlanProperties

Struttura che specifica le proprietà di una VLAN con una modalità operativa di NdisSwitchPortVlanModeAccess o NdisSwitchPortVlanModeTrunk. Questa struttura contiene i membri seguenti:

VlanProperties.AccessVlanId

Valore UINT16 che specifica l'identificatore VLAN per la porta del commutatore estendibile che opera in modalità di accesso VLAN.

Nota Questo membro è valido solo se il membro OperationMode è impostato su NdisSwitchPortVlanModeAccess.

VlanProperties.NativeVlanId

Valore UINT16 che specifica l'identificatore VLAN per la porta del commutatore estendibile che opera in modalità trunk VLAN.

VlanProperties.PruneVlanIdArray[64]

Matrice di elementi UINT64 che specifica gli identificatori VLAN i cui pacchetti sono bloccati su una porta commutatore estendibile.

La matrice ha 64 elementi UINT64 che rappresentano 4096 bit consecutivi. Ogni bit con un valore pari a uno specifica un identificatore VLAN i cui pacchetti sono bloccati per l'invio o la ricezione su una porta commutatore estendibile. Ad esempio, se il bit 3 è impostato su uno, il traffico di pacchetti dall'identificatore VLAN 3 viene bloccato su una porta. Analogamente, se il bit 64 è impostato su zero, il traffico dei pacchetti dall'identificatore VLAN 64 non viene bloccato su una porta.

Nota Le VLAN con identificatori che eseguono il mapping a un valore di bit pari a uno vengono sempre bloccate. In questo modo viene ignorata l'impostazione di bit equivalente per l'identificatore VLAN nel membro TrunkVlanIdArray .

VlanProperties.TrunkVlanIdArray[64]

Matrice di elementi UINT64 che specifica gli identificatori VLAN i cui pacchetti sono consentiti su una porta commutatore estendibile.

La matrice ha 64 elementi UINT64 che rappresentano 4096 bit consecutivi. Ogni bit con un valore pari a uno specifica un identificatore VLAN i cui pacchetti possono essere inviati o ricevuti su una porta commutatore estendibile. Ad esempio, se il bit due è impostato su uno, il traffico di pacchetti dall'identificatore VLAN due è consentito su una porta. Analogamente, se il bit 1954 è impostato su zero, il traffico dei pacchetti dall'identificatore VLAN 1954 non è consentito su una porta.

PvlanProperties

Struttura che specifica le proprietà di una VLAN con una modalità operativa di NdisSwitchPortVlanModePrivate. Questa struttura contiene i membri seguenti:

PvlanProperties.PvlanMode

Valore di enumerazione NDIS_SWITCH_PORT_PVLAN_MODE che specifica la modalità operativa della PVLAN.

PvlanProperties.PrimaryVlanId

Valore UINT16 che specifica l'identificatore VLAN primario per una porta commutatore estendibile.

Nota Questo membro è valido solo se il membro PvlanMode è impostato su NdisSwitchPortPvlanModeCommunity.

PvlanProperties.SecondaryVlanId

Valore UINT16 che specifica l'identificatore VLAN secondario per una porta del commutatore estendibile.

Nota Questo membro è valido solo se il membro PvlanMode è impostato su NdisSwitchPortPvlanModeIsolated o NdisSwitchPortPvlanModeCommunity.

PvlanProperties.SecondaryVlanIdArray[64]

Matrice di elementi UINT64 che specificano gli identificatori VLAN secondari per una porta commutatore estendibile.

La matrice ha 64 elementi UINT64, che rappresentano 4096 bit consecutivi. Ogni bit con un valore pari a uno specifica un identificatore VLAN secondario per la porta del commutatore estendibile. Ad esempio, se il bit cinque è impostato su uno, l'identificatore VLAN secondario è cinque. Analogamente, se bit 128 è impostato su zero, non è possibile usare 128 come identificatore VLAN secondario.

Nota Questo membro è valido solo se il membro PvlanMode è impostato su NdisSwitchPortPvlanModePromiscuous.

Commenti

La struttura NDIS_SWITCH_PORT_PROPERTY_VLAN viene usata nelle richieste di set OID seguenti:

La struttura NDIS_SWITCH_PORT_PROPERTY_VLAN segue la struttura NDIS_SWITCH_PORT_PROPERTY_PARAMETERS nel buffer associato a queste richieste di set OID. Il membro InformationBuffer della struttura NDIS_OID_REQUEST contiene un puntatore a questo buffer.

Le proprietà delle porte, ad esempio NDIS_SWITCH_PORT_PROPERTY_VLAN, vengono applicate dall'estensione del commutatore estendibile installata come estensione di inoltro. Questo tipo di estensione applica le proprie regole per l'inoltro di pacchetti, URI e indicazioni sullo stato tramite lo stack di driver del commutatore estendibile. Può essere presente una sola estensione di inoltro per ogni istanza di un commutatore estendibile.

Per altre informazioni sull'inoltro delle estensioni, vedere Forwarding Extensions.For more information on forwarding extensions, see Forwarding Extensions.

Nota Se un'estensione di inoltro non è installata, l'interfaccia del commutatore estendibile applica la proprietà della porta stessa.