OID_NIC_SWITCH_HARDWARE_CAPABILITIES
Un pilote overlying émet une requête d’identificateur d’objet (OID) de OID_NIC_SWITCH_HARDWARE_CAPABILITIES pour obtenir les fonctionnalités matérielles du commutateur de carte réseau dans la carte réseau.
Après un retour réussi de la requête de requête OID, le membre InformationBuffer de la structure NDIS_OID_REQUEST contient un pointeur vers une structure NDIS_NIC_SWITCH_CAPABILITIES .
Notes
La structure NDIS_NIC_SWITCH_CAPABILITIES contient des informations sur les fonctionnalités matérielles d’un commutateur de carte réseau sur la carte réseau. Ces fonctionnalités peuvent inclure les fonctionnalités matérielles actuellement désactivées par les paramètres du fichier INF ou via la page Propriétés avancées .
Note Toutes les fonctionnalités du commutateur de carte réseau spécifié sont retournées par le biais d’une requête OID de OID_NIC_SWITCH_HARDWARE_CAPABILITIES, qu’une fonctionnalité soit activée ou désactivée.
À compter de NDIS 6.20, les pilotes miniport fournissent les fonctionnalités matérielles du commutateur de carte réseau lorsque sa fonction MiniportInitializeEx est appelée. Le pilote initialise une structure de NDIS_NIC_SWITCH_CAPABILITIES avec les fonctionnalités matérielles du commutateur de carte réseau et définit le membre HardwareNicSwitchCapabilities de la structure NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES sur un pointeur vers la structure NDIS_NIC_SWITCH_CAPABILITIES . Le pilote miniport appelle ensuite la fonction NdisMSetMiniportAttributes et définit le paramètre MiniportAttributes sur un pointeur vers une structure NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES .
Note À compter de NDIS 6.30, les pilotes miniport qui prennent en charge l’interface de virtualisation d’E/S racine unique (SR-IOV) doivent inscrire les fonctionnalités matérielles du commutateur de carte réseau. Les pilotes inscrivent ces fonctionnalités en appelant NdisMSetMiniportAttributes.
Codes d’état de retour
NDIS gère la requête OID de OID_NIC_SWITCH_HARDWARE_CAPABILITIES demande pour les pilotes miniport et retourne l’un des codes de status suivants :
| Code d’état | Description |
|---|---|
NDIS_STATUS_SUCCESS |
La demande s’est terminée avec succès. InformationBuffer pointe vers une structure NDIS_NIC_SWITCH_CAPABILITIES. |
NDIS_STATUS_NOT_SUPPORTED |
Le pilote miniport ne prend pas en charge l’interface de virtualisation 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). NDIS définit les DONNÉES. QUERY_INFORMATION. Le membre BytesNeeded dans le NDIS_OID_REQUEST structure à la taille de mémoire tampon minimale requise. |
NDIS_STATUS_FAILURE |
La demande a échoué pour d’autres raisons. |
Spécifications
Version |
Pris en charge dans NDIS 6.20 et versions ultérieures. |
En-tête |
Ntddndis.h (inclure Ndis.h) |