NDIS_SWITCH_PORT_PROPERTY_VLAN structure (ntddndis.h)
The NDIS_SWITCH_PORT_PROPERTY_VLAN structure specifies a virtual local area network (VLAN) policy property for a Hyper-V extensible switch port.
Syntax
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
The type, revision, and size of the NDIS_SWITCH_PORT_PROPERTY_VLAN structure. This member is formatted as an NDIS_OBJECT_HEADER structure.
The Type member of Header must be set to NDIS_OBJECT_TYPE_DEFAULT. To specify the version of the NDIS_SWITCH_PORT_PROPERTY_VLAN structure, the Revision member of Header must be set to the following value:
NDIS_SWITCH_PORT_PROPERTY_VLAN_REVISION_1
Original version for NDIS 6.30 and later.
Set the Size member to NDIS_SIZEOF_NDIS_SWITCH_PORT_PROPERTY_VLAN_REVISION_1.
Flags
A ULONG value that contains a bitwise OR of flags. This member is reserved for NDIS.
OperationMode
An NDIS_SWITCH_PORT_VLAN_MODE enumeration value that specifies the operation mode of the VLAN.
VlanProperties
A structure that specifies the properties of a VLAN with an operation mode of NdisSwitchPortVlanModeAccess or NdisSwitchPortVlanModeTrunk. This structure contains the following members:
VlanProperties.AccessVlanId
A UINT16 value that specifies the VLAN identifier for the extensible switch port that operates in VLAN access mode.
VlanProperties.NativeVlanId
A UINT16 value that specifies the VLAN identifier for the extensible switch port that operates in VLAN trunk mode.
VlanProperties.PruneVlanIdArray[64]
An array of UINT64 elements that specifies VLAN identifiers whose packets are blocked on an extensible switch port.
The array has 64 UINT64 elements that represent 4096 consecutive bits. Each bit that has a value of one specifies a VLAN identifier whose packets are blocked from being sent or received on an extensible switch port. For example, if bit three is set to one, packet traffic from VLAN identifier three is blocked on a port. Similarly, if bit 64 is set to zero, packet traffic from VLAN identifier 64 is not blocked on a port.
VlanProperties.TrunkVlanIdArray[64]
An array of UINT64 elements that specifies VLAN identifiers whose packets are allowed on an extensible switch port.
The array has 64 UINT64 elements that represent 4096 consecutive bits. Each bit that has a value of one specifies a VLAN identifier whose packets are allowed to be sent or received on an extensible switch port. For example, if bit two is set to one, packet traffic from VLAN identifier two is allowed on a port. Similarly, if bit 1954 is set to zero, packet traffic from VLAN identifier 1954 is not allowed on a port.
PvlanProperties
A structure that specifies the properties of a VLAN with an operation mode of NdisSwitchPortVlanModePrivate. This structure contains the following members:
PvlanProperties.PvlanMode
An NDIS_SWITCH_PORT_PVLAN_MODE enumeration value that specifies the operation mode of the PVLAN.
PvlanProperties.PrimaryVlanId
A UINT16 value that specifies the primary VLAN identifier for an extensible switch port.
PvlanProperties.SecondaryVlanId
A UINT16 value that specifies the secondary VLAN identifier for an extensible switch port.
PvlanProperties.SecondaryVlanIdArray[64]
An array of UINT64 elements that specify the secondary VLAN identifiers for an extensible switch port.
The array has 64 UINT64 elements, which represent 4096 consecutive bits. Each bit that has a value of one specifies a secondary VLAN identifier for the extensible switch port. For example, if bit five is set to one, the secondary VLAN identifier is five. Similarly, if bit 128 is set to zero, 128 cannot be used as a secondary VLAN identifier.
Remarks
The NDIS_SWITCH_PORT_PROPERTY_VLAN structure is used in the following OID set requests:
The NDIS_SWITCH_PORT_PROPERTY_VLAN structure follows the NDIS_SWITCH_PORT_PROPERTY_PARAMETERS structure in the buffer that is associated with these OID set requests. The InformationBuffer member of the NDIS_OID_REQUEST structure contains a pointer to this buffer.Port properties, such as NDIS_SWITCH_PORT_PROPERTY_VLAN, are enforced by the extensible switch extension that is installed as a forwarding extension. This type of extension enforces its own rules for forwarding packets, OIDs, and status indications through the extensible switch driver stack. There can be only one forwarding extension per each instance of an extensible switch.
For more information on forwarding extensions, see Forwarding Extensions.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Supported in NDIS 6.30 and later. |
| Header | ntddndis.h (include Ndis.h) |
See also