NDIS_SWITCH_NIC_OID_REQUEST structure (ntddndis.h)

Article
08/07/2023

La structure NDIS_SWITCH_NIC_OID_REQUEST spécifie les informations requises pour transférer ou créer des demandes OID.

Syntaxe

typedef struct _NDIS_SWITCH_NIC_OID_REQUEST {
  NDIS_OBJECT_HEADER    Header;
  ULONG                 Flags;
  NDIS_SWITCH_PORT_ID   SourcePortId;
  NDIS_SWITCH_NIC_INDEX SourceNicIndex;
  NDIS_SWITCH_PORT_ID   DestinationPortId;
  NDIS_SWITCH_NIC_INDEX DestinationNicIndex;
  PNDIS_OID_REQUEST     OidRequest;
} NDIS_SWITCH_NIC_OID_REQUEST, *PNDIS_SWITCH_NIC_OID_REQUEST;

Membres

Header

Type, révision et taille de la structure NDIS_SWITCH_NIC_OID_REQUEST . 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_NIC_OID_REQUEST , le membre Revision de Header doit être défini sur la valeur suivante :

NDIS_SWITCH_NIC_OID_REQUEST_REVISION_1

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

Définissez le membre Size sur NDIS_SIZEOF_NDIS_SWITCH_NIC_OID_REQUEST_REVISION_1.

Flags

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

SourcePortId

Valeur NDIS_SWITCH_PORT_ID qui contient l’identificateur unique du port de commutateur extensible Hyper-V sur lequel la demande OID a été initialement émise.

SourceNicIndex

Valeur NDIS_SWITCH_NIC_INDEX qui spécifie l’index de la carte réseau source connectée au port de commutateur extensible source spécifié par le membre SourcePortId .

DestinationPortId

Valeur NDIS_SWITCH_PORT_ID qui contient l’identificateur unique du port de commutateur extensible vers lequel la requête OID doit être transférée.

DestinationNicIndex

Valeur NDIS_SWITCH_NIC_INDEX qui spécifie l’index de la carte réseau de destination connectée au port de commutateur extensible spécifié par le membre DestinationPortId .

OidRequest

Pointeur vers une structure NDIS_OID_REQUEST . Cette structure contient les données de la requête OID qui seront transférées au pilote miniport de la carte réseau spécifiée par les membres DestinationPortId et DestinationNicIndex .

Remarques

La structure NDIS_SWITCH_NIC_OID_REQUEST est utilisée dans les requêtes de méthode OID de OID_SWITCH_NIC_REQUEST.

Une extension peut transférer ou créer des requêtes OID vers des cartes réseau physiques sous-jacentes dans la pile de pilotes de commutateur extensible. Cela permet à une extension d’effectuer les opérations suivantes :

Gérez la configuration des déchargements matériels sur une carte physique sous-jacente pour les technologies de déchargement suivantes :
- Sécurité du protocole Internet (IPsec).
- File d’attente de machines virtuelles (VMQ).
- Virtualisation d’E/S d’une racine unique (SR-IOV)
Interrogez la configuration d’une carte réseau physique sous-jacente en émettant des OID NDIS standard. Par exemple, l’extension peut émettre une requête OID de OID_802_3_CURRENT_ADDRESS pour obtenir l’adresse MAC (Media Access Control) actuelle de l’adaptateur.

Pour obtenir des instructions sur la façon d’émettre des demandes OID aux cartes physiques sous-jacentes, consultez Gestion des demandes d’OID aux cartes réseau physiques.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Pris en charge dans NDIS 6.30 et versions ultérieures.
En-tête	ntddndis.h (include Ndis.h)

Voir aussi

NDIS_OBJECT_HEADER

NDIS_OID_REQUEST

OID_SWITCH_NIC_REQUEST

Partager via