OID_SRIOV_CURRENT_CAPABILITIES

Article
06/15/2023

Un pilote qui se superpose émet une requête d’identificateur d’objet (OID) de OID_SRIOV_CURRENT_CAPABILITIES pour obtenir les fonctionnalités actuelles de virtualisation d’E/S racine (SR-IOV) d’une carte réseau.

Le membre InformationBuffer de la structure NDIS_OID_REQUEST contient un pointeur vers la structure NDIS_SRIOV_CAPABILITIES .

Notes

À compter de NDIS 6.30, les pilotes miniport fournissent les fonctionnalités matérielles SR-IOV activées sur la carte réseau lorsque sa fonction MiniportInitializeEx est appelée. Le pilote initialise une structure NDIS_SRIOV_CAPABILITIES avec les fonctionnalités matérielles SR-IOV actuellement activées et définit le membre CurrentSriovCapabilities 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 .

Les pilotes de protocole et de filtre excessivement appliqués n’ont pas besoin d’émettre des requêtes OID de OID_SRIOV_CURRENT_CAPABILITIES. NDIS fournit les fonctionnalités SR-IOV actuellement activées d’une carte réseau à ces pilotes de la manière suivante :

NDIS signale les fonctionnalités SR-IOV actuellement activées d’une carte réseau sous-jacente aux pilotes de protocole trop haut dans le membre SriovCapabilities de la structure NDIS_BIND_PARAMETERS pendant l’opération de liaison.
NDIS signale les fonctionnalités SR-IOV actuellement activées d’une carte réseau sous-jacente aux pilotes de filtre sur-jacents dans le membre SriovCapabilities de la structure NDIS_FILTER_ATTACH_PARAMETERS pendant l’opération d’attachement.

Codes d’état de retour

NDIS gère la requête OID de la demande de OID_SRIOV_CURRENT_CAPABILITIES pour les pilotes miniport. Les pilotes ne seront pas émis cette demande OID.

Lorsque NDIS gère la demande de OID_SRIOV_CURRENT_CAPABILITIES, il retourne l’un des codes status suivants :

Code d’état	Description
NDIS_STATUS_SUCCESS	La demande 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. BytesNeeded membre dans la structure NDIS_OID_REQUEST à la taille de mémoire tampon minimale requise.
NDIS_STATUS_FAILURE	La demande a échoué pour d’autres raisons.