Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Un pilote surlysant émet une demande de requête d’identificateur d’objet (OID) de OID_NIC_SWITCH_CURRENT_CAPABILITIES pour obtenir les fonctionnalités matérielles actuellement activées du commutateur de carte réseau dans une carte réseau.
Après un retour réussi de la requête OID, l'InformationBuffer membre de la structure NDIS_OID_REQUEST contient un pointeur vers une structure NDIS_NIC_SWITCH_CAPABILITIES.
Remarques
À compter de NDIS 6.20, les pilotes miniport fournissent les fonctionnalités matérielles de commutateur de carte réseau actuellement activées sur la carte réseau lorsque sa fonction MiniportInitializeEx est appelée. Le pilote initialise une structure NDIS_NIC_SWITCH_CAPABILITIES avec les fonctionnalités matérielles du commutateur de carte réseau et définit le membre CurrentNicSwitchCapabilities de la structure NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES vers un pointeur vers la structure NDIS_NIC_SWITCH_CAPABILITIES. Le pilote miniport appelle ensuite la fonction NdisMSetMiniportAttributes et définit le paramètre MiniportAttributes à un pointeur vers une structure NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES.
Remarque À compter de NDIS 6.30, les pilotes miniport qui prennent en charge la virtualisation d’E/S racine unique (SR-IOV) doivent inscrire les fonctionnalités matérielles activées du commutateur de carte réseau. Les pilotes inscrivent ces fonctionnalités en appelant NdisMSetMiniportAttributes.
Le protocole overlying et les pilotes de filtre n’ont pas besoin d’émettre des requêtes OID de OID_NIC_SWITCH_CURRENT_CAPABILITIES. NDIS fournit les fonctionnalités matérielles de commutateur de carte réseau actuellement activées d’une carte réseau à ces pilotes de la manière suivante :
NDIS signale les fonctionnalités matérielles de commutateur de carte réseau actuellement activées d’une carte réseau sous-jacente pour superposer les pilotes de protocole dans les NicSwitchCapabilities membre de la structure NDIS_BIND_PARAMETERS pendant l’opération de liaison.
NDIS signale les fonctionnalités matérielles de commutateur de carte réseau actuellement activées d’une carte réseau sous-jacente pour filtrer les pilotes dans les NicSwitchCapabilities membre de la structure de NDIS_FILTER_ATTACH_PARAMETERS pendant l’opération d’attachement.
Codes d’état de retour
NDIS gère la requête de requête OID de la requête OID_NIC_SWITCH_CURRENT_CAPABILITIES pour les pilotes miniport. Les pilotes ne seront pas émis cette demande OID.
Quand NDIS gère la requête OID_NIC_SWITCH_CURRENT_CAPABILITIES, elle retourne l’un des codes d’état suivants :
| Code d’état | Description |
|---|---|
NDIS_STATUS_SUCCESS |
La demande s’est terminée avec succès. Le InformationBuffer pointe vers une structure NDIS_NIC_SWITCH_CAPABILITIES. |
NDIS_STATUS_NOT_SUPPORTED |
Le pilote miniport ne prend pas en charge l’interface d’E/S racine unique (SR-IOV) ou n’est pas activé pour utiliser l’interface. |
NDIS_STATUS_INVALID_LENGTH |
La longueur de la mémoire tampon d’informations est inférieure à sizeof(NDIS_NIC_SWITCH_CAPABILITIES). Le pilote miniport doit définir la DATA. QUERY_INFORMATION. OctetsNeeded membre de la structure NDIS_OID_REQUEST à la taille de mémoire tampon minimale requise. |
NDIS_STATUS_FAILURE |
La demande a échoué pour d’autres raisons. |
Exigences
Version |
Pris en charge dans NDIS 6.20 et versions ultérieures. |
En-tête |
Ntddndis.h (include Ndis.h) |