structure NDIS_SWITCH_PARAMETERS (ntddndis.h)

Article
02/26/2024

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

Syntaxe

typedef struct _NDIS_SWITCH_PARAMETERS {
  NDIS_OBJECT_HEADER       Header;
  ULONG                    Flags;
  NDIS_SWITCH_NAME         SwitchName;
  NDIS_SWITCH_FRIENDLYNAME SwitchFriendlyName;
  UINT32                   NumSwitchPorts;
  BOOLEAN                  IsActive;
} NDIS_SWITCH_PARAMETERS, *PNDIS_SWITCH_PARAMETERS;

Membres

Header

Type, révision et taille de la structure NDIS_SWITCH_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_PARAMETERS , le membre Révision de l’en-tête doit avoir la valeur suivante :

NDIS_SWITCH_PARAMETERS_REVISION_1

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

Définissez le membre Size sur NDIS_SIZEOF_NDIS_SWITCH_PARAMETERS_REVISION_1.

Flags

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

SwitchName

Valeur NDIS_SWITCH_NAME qui spécifie le nom interne unique du commutateur extensible.

Le nom du commutateur 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.

SwitchFriendlyName

Valeur NDIS_SWITCH_FRIENDLYNAME qui spécifie la description conviviale du commutateur extensible.

NumSwitchPorts

Valeur UINT32 qui spécifie le nombre de ports configurés sur le commutateur extensible.

IsActive

BOOLEAN qui, si TRUE indique que l’activation du commutateur extensible Hyper-V est terminée et qu’il est possible d’interroger en toute sécurité d’autres configurations de commutateur, telles que l’énumération des ports, des cartes réseau et des propriétés. Si la valeur est FALSE, l’extension doit attendre que l’événement PNP NetEventSwitchActivate soit émis avant d’interroger la configuration du commutateur.

Remarques

La structure NDIS_SWITCH_PARAMETERS est utilisée dans la requête OID de OID_SWITCH_PARAMETERS.

Cette structure est également transmise dans le paramètre vSwitch des fonctions de légende suivantes pour les pilotes de légende de la plateforme de filtrage Windows :

Note Les types de données NDIS_SWITCH_NAME et NDIS_SWITCH_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 est terminée par null, le membre Length ne doit pas inclure le caractère null de fin.