OID_SRIOV_HARDWARE_CAPABILITIES
Un pilote overlying émet une demande de requête d’identificateur d’objet (OID) de OID_SRIOV_HARDWARE_CAPABILITIES pour obtenir les fonctionnalités matérielles de virtualisation d’E/S (SR-IOV) racine unique de la carte réseau.
Le membre InformationBuffer de la structure NDIS_OID_REQUEST contient un pointeur vers la structure NDIS_SRIOV_CAPABILITIES .
Notes
La structure NDIS_SRIOV_CAPABILITIES contient des informations sur les fonctionnalités matérielles de la carte réseau, par exemple si la carte prend en charge SR-IOV et si le pilote miniport gère la fonction physique PCI Express (PCIe) ou la fonction virtuelle (VF) de l’adaptateur. 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 SR-IOV de la carte réseau sont retournées par le biais d’une requête OID de OID_SRIOV_HARDWARE_CAPABILITIES, qu’une fonctionnalité soit activée ou désactivée.
À compter de NDIS 6.30, les pilotes miniport fournissent les fonctionnalités matérielles SR-IOV lorsque sa fonction MiniportInitializeEx est appelée. Le pilote initialise une structure de NDIS_SRIOV_CAPABILITIES avec les fonctionnalités matérielles SR-IOV et définit le membre HardwareSriovCapabilities de la structure NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES sur un pointeur vers la structure NDIS_SRIOV_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 .
Codes d’état de retour
NDIS gère la requête OID de la demande de OID_SRIOV_HARDWARE_CAPABILITIES pour les pilotes miniport. Les pilotes ne seront pas émis cette demande OID.
Lorsque NDIS gère la requête OID_SRIOV_HARDWARE_CAPABILITIES, il retourne l’un des codes status suivants.
Code d’état | Description |
---|---|
NDIS_STATUS_SUCCESS |
La requête OID s’est terminée avec succès. |
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 mémoire tampon d’informations était trop courte. Le pilote miniport doit définir 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.30 et versions ultérieures. |
En-tête |
Ntddndis.h (inclure Ndis.h) |