struttura NDIS_SWITCH_PORT_PROPERTY_SECURITY (ntddndis.h)

Articolo
08/07/2023

La struttura NDIS_SWITCH_PORT_PROPERTY_SECURITY specifica una proprietà dei criteri di sicurezza per una porta commutatore estendibile Hyper-V.

Sintassi

typedef struct _NDIS_SWITCH_PORT_PROPERTY_SECURITY {
  NDIS_OBJECT_HEADER Header;
  ULONG              Flags;
  BOOLEAN            AllowMacSpoofing;
  BOOLEAN            AllowIeeePriorityTag;
  UINT32             VirtualSubnetId;
  BOOLEAN            AllowTeaming;
  UINT32             DynamicIPAddressLimit;
} NDIS_SWITCH_PORT_PROPERTY_SECURITY, *PNDIS_SWITCH_PORT_PROPERTY_SECURITY;

Members

Header

Tipo, revisione e dimensioni della struttura NDIS_SWITCH_PORT_PROPERTY_SECURITY . 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_SECURITY , il membro Revision di Header deve essere impostato sul valore seguente:

NDIS_SWITCH_PORT_PROPERTY_SECURITY_REVISION_1

Versione originale per NDIS 6.30 e versioni successive.

Impostare il membro Sizesu NDIS_SIZEOF_NDIS_SWITCH_PROPERTY_SECURITY_REVISION_1.

Flags

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

AllowMacSpoofing

Valore BOOLEAN che, se impostato su TRUE, specifica che la porta può inviare pacchetti con un indirizzo MAC (Source Media Access Control) diverso dall'indirizzo MAC permanente. L'indirizzo MAC permanente della porta viene configurato tramite una richiesta di set di identificatori di oggetto (OID) di OID_SWITCH_NIC_CREATE.

AllowIeeePriorityTag

Valore BOOLEAN che, se impostato su TRUE, specifica che la porta deve mantenere le informazioni sulla priorità 802.1Q nella struttura di NET_BUFFER_LIST di un pacchetto quando il pacchetto viene inoltrato alla porta. La porta deve mantenere le informazioni di priorità solo se il membro PreservePriority è impostato nell'unione NDIS_SWITCH_FORWARDING_DETAIL_NET_BUFFER_LIST_INFO dei dati fuori banda della struttura NET_BUFFER_LIST del pacchetto.

VirtualSubnetId

Valore UINT32 che specifica la virtualizzazione di rete VirtualSubnetId configurata sulla porta. Se la virtualizzazione di rete non è configurata sulla porta, il valore sarà 0. I dati NDIS_NET_BUFFER_LIST_VIRTUAL_SUBNET_INFO fuori banda del NET_BUFFER_LIST contengono il VirtualSubnetId, popolato con l'appartenenza alla subnet virtuale del traffico.

AllowTeaming

Valore BOOLEAN che, se impostato su TRUE, specifica che è consentito il failover di raggruppamento per la porta, in modo che la porta possa inviare pacchetti con un indirizzo MAC (Source Media Access Control) diverso dal relativo oggetto PermanentMacAddress, ma uguale all'indirizzo MAC attualmente in uso da un'altra porta connessa alla stessa macchina virtuale. L'indirizzo MAC permanente della porta viene configurato tramite una richiesta di set OID (Object Identifier) di OID_SWITCH_NIC_CREATE/OID_SWITCH_NIC_UPDATE.

DynamicIPAddressLimit

Valore UINT32 che specifica il numero massimo di indirizzi IP dinamici che è possibile apprendere per la porta.

Commenti

La struttura NDIS_SWITCH_PORT_PROPERTY_SECURITY viene usata nelle richieste del set OID seguenti:

La struttura NDIS_SWITCH_PORT_PROPERTY_SECURITY segue la struttura NDIS_SWITCH_PORT_PROPERTY_PARAMETERS nel buffer associato a queste richieste del 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_SECURITY, 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.