struttura NDIS_SWITCH_PORT_PARAMETERS (ntddndis.h)

Articolo
02/26/2024

La struttura NDIS_SWITCH_PORT_PARAMETERS contiene i dati di configurazione per una porta del commutatore estendibile Hyper-V.

Sintassi

typedef struct _NDIS_SWITCH_PORT_PARAMETERS {
  NDIS_OBJECT_HEADER            Header;
  ULONG                         Flags;
  NDIS_SWITCH_PORT_ID           PortId;
  NDIS_SWITCH_PORT_NAME         PortName;
  NDIS_SWITCH_PORT_FRIENDLYNAME PortFriendlyName;
  NDIS_SWITCH_PORT_TYPE         PortType;
  BOOLEAN                       IsValidationPort;
  NDIS_SWITCH_PORT_STATE        PortState;
} NDIS_SWITCH_PORT_PARAMETERS, *PNDIS_SWITCH_PORT_PARAMETERS;

Members

Header

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

NDIS_SWITCH_PORT_PARAMETERS_REVISION_1

Versione originale per NDIS 6.30 e versioni successive.

Impostare il membro Size su NDIS_SIZEOF_NDIS_SWITCH_PORT_PARAMETERS_REVISION_1.

Flags

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

PortId

Valore NDIS_SWITCH_PORT_ID che contiene l'identificatore univoco della porta del commutatore estendibile.

PortName

Valore NDIS_SWITCH_PORT_NAME che specifica il nome interno univoco della porta del commutatore estendibile.

Il nome della porta interna viene usato dalle applicazioni di gestione dei criteri basate su WMI. Per altre informazioni, vedere Managing Hyper-V Extensible Switch Policies .For more information, see Managing Hyper-V Extensible Switch Policies.

PortFriendlyName

Valore NDIS_SWITCH_PORT_FRIENDLYNAME che specifica la descrizione intuitiva della porta del commutatore estendibile.

PortType

Valore NDIS_SWITCH_PORT_TYPE che specifica il tipo della porta del commutatore estendibile.

IsValidationPort

Se TRUE, indica una porta creata temporaneamente per scopi di test e convalida prima che venga stabilita una connessione alla scheda di rete della macchina virtuale. Per altre informazioni su questo tipo di porta, vedere Porte di convalida.

PortState

Valore NDIS_SWITCH_PORT_STATE che specifica lo stato corrente della porta.

Commenti

Il membro InformationBuffer della struttura NDIS_OID_REQUEST contiene un puntatore a una struttura NDIS_SWITCH_PORT_PARAMETERS per le richieste OID seguenti:

Le richieste di query OID di OID_SWITCH_PORT_ARRAY restituiscono una struttura NDIS_SWITCH_PORT_ARRAY che contiene una matrice di elementi. Ogni elemento viene formattato come struttura NDIS_SWITCH_PORT_PARAMETERS .

Le estensioni del commutatore estendibile possono accedere al buffer delle proprietà della porta all'interno di una struttura NDIS_SWITCH_PORT_PARAMETERS usando la macro NDIS_SWITCH_PORT_AT_ARRAY_INDEX .

Nota I tipi di dati NDIS_SWITCH_PORT_NAME e NDIS_SWITCH_PORT_FRIENDLYNAME sono definiti dalla struttura IF_COUNTED_STRING . Non è necessario che una stringa definita da questa struttura sia con terminazione Null. Tuttavia, la lunghezza della stringa deve essere impostata nel membro Length di questa struttura. Se la stringa è con terminazione Null, il membro Length non deve includere il carattere Null di terminazione.