NDIS_SWITCH_PORT_PARAMETERS structure (ntddndis.h)

Article
02/26/2024

La structure NDIS_SWITCH_PORT_PARAMETERS contient les données de configuration d’un port de commutateur extensible Hyper-V.

Syntaxe

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;

Membres

Header

Type, révision et taille de la structure NDIS_SWITCH_PORT_PARAMETERS . Ce membre est mis en forme en tant que structure NDIS_OBJECT_HEADER .

Le membre Type de l’en-tête doit être défini sur NDIS_OBJECT_TYPE_DEFAULT. Pour spécifier la version de la structure NDIS_SWITCH_PORT_PARAMETERS , le membre Revision de Header doit être défini sur la valeur suivante :

NDIS_SWITCH_PORT_PARAMETERS_REVISION_1

Version d’origine pour NDIS 6.30 et versions ultérieures.

Définissez le membre Taille sur NDIS_SIZEOF_NDIS_SWITCH_PORT_PARAMETERS_REVISION_1.

Flags

Valeur ULONG qui contient un OR au niveau du bit d’indicateurs. Ce membre est réservé à NDIS.

PortId

Valeur NDIS_SWITCH_PORT_ID qui contient l’identificateur unique du port de commutateur extensible.

PortName

Valeur NDIS_SWITCH_PORT_NAME qui spécifie le nom interne unique du port de commutateur extensible.

Le nom de port interne est utilisé par les applications de gestion des stratégies basées sur WMI. Pour plus d’informations, consultez Gestion des stratégies de commutateur extensible Hyper-V.

PortFriendlyName

Valeur NDIS_SWITCH_PORT_FRIENDLYNAME qui spécifie la description conviviale du port de commutateur extensible.

PortType

Valeur NDIS_SWITCH_PORT_TYPE qui spécifie le type du port de commutateur extensible.

IsValidationPort

Si la valeur est TRUE, indique un port qui est temporairement créé à des fins de test et de validation avant l’établissement d’une connexion de carte réseau de machine virtuelle. Pour plus d’informations sur ce type de port, consultez Ports de validation.

PortState

Valeur NDIS_SWITCH_PORT_STATE qui spécifie l’état actuel du port.

Remarques

Le membre InformationBuffer de la structure NDIS_OID_REQUEST contient un pointeur vers une structure NDIS_SWITCH_PORT_PARAMETERS pour les requêtes OID suivantes :

Les requêtes OID de OID_SWITCH_PORT_ARRAY retournent une structure NDIS_SWITCH_PORT_ARRAY qui contient un tableau d’éléments. Chaque élément est mis en forme en tant que structure NDIS_SWITCH_PORT_PARAMETERS .

Les extensions de commutateur extensibles peuvent accéder à la mémoire tampon de propriété de port à l’intérieur d’une structure NDIS_SWITCH_PORT_PARAMETERS à l’aide de la macro NDIS_SWITCH_PORT_AT_ARRAY_INDEX .

Note Les types de données NDIS_SWITCH_PORT_NAME et NDIS_SWITCH_PORT_FRIENDLYNAME sont définis par la structure IF_COUNTED_STRING . Une chaîne définie par cette structure n’a pas besoin d’être terminée par null. Toutefois, la longueur de la chaîne doit être définie dans le membre Length de cette structure. Si la chaîne se termine par un caractère Null, le membre Length ne doit pas inclure le caractère null de fin.