OID_NIC_SWITCH_VF_PARAMETERS

Article
06/15/2023

Un pilote ou une application en mode utilisateur excessive émet une demande de méthode d’identificateur d’objet (OID) de OID_NIC_SWITCH_VF_PARAMETERS pour obtenir les paramètres de configuration actuels d’une fonction virtuelle (VF) PCI Express (PCIe) sur une carte réseau. Seules les machines virtuelles qui ont des ressources allouées via une demande de méthode OID de OID_NIC_SWITCH_ALLOCATE_VF peuvent être interrogées via une demande de méthode OID de OID_NIC_SWITCH_VF_PARAMETERS.

NDIS gère la demande de méthode OID de OID_NIC_SWITCH_VF_PARAMETERS pour les pilotes miniport.

Lorsque la demande de méthode OID est effectuée, le membre InformationBuffer de la structure NDIS_OID_REQUEST contient un pointeur vers une structure NDIS_NIC_SWITCH_VF_PARAMETERS .

Notes

Le pilote ou l’application en mode utilisateur surchargé spécifie la VF à interroger en définissant le membre VFId de la structure NDIS_NIC_SWITCH_VF_PARAMETERS sur l’identificateur de la VF. Le pilote ou l’application qui se superpose obtient l’identificateur VF de l’une des manières suivantes :

En émettant une demande de méthode OID de OID_NIC_SWITCH_ENUM_VFS.

Si cette demande OID est effectuée avec succès, le pilote ou l’application en mode utilisateur de surlignement reçoit la liste de toutes les machines virtuelles allouées sur la carte réseau. Chaque élément de la liste est une structure NDIS_NIC_SWITCH_VF_INFO , avec l’identificateur VF spécifié par le membre VFId .
En émettant une demande de méthode OID de OID_NIC_SWITCH_ALLOCATE_VF.

Si cette demande OID est effectuée avec succès, le pilote surchargé reçoit l’identificateur de la VF nouvellement créée dans le membre VFId de la structure NDIS_NIC_SWITCH_VF_PARAMETERS retournée.

Note Seuls les pilotes qui se superposent peuvent obtenir l’identificateur VF de cette manière.

Après un retour réussi à partir de la demande de méthode OID, le membre InformationBuffer de la structure NDIS_OID_REQUEST contient un pointeur vers une structure NDIS_NIC_SWITCH_VF_PARAMETERS . Cette structure contient les paramètres de configuration de la VF spécifiée.

Codes d’état de retour

NDIS gère la demande de méthode OID de OID_NIC_SWITCH_VF_PARAMETERS pour les pilotes miniport et retourne le code status suivant pour les demandes de méthode OID de OID_NIC_SWITCH_VF_PARAMETERS.

Code d’état	Description
NDIS_STATUS_SUCCESS	La demande s’est terminée avec succès. Le membre InformationBuffer pointe vers une structure NDIS_NIC_SWITCH_VF_PARAMETERS .
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_PARAMETER	Un ou plusieurs des membres de la structure NDIS_NIC_SWITCH_VF_PARAMETERS ont des valeurs non valides.
NDIS_STATUS_INVALID_LENGTH	La longueur de la mémoire tampon d’informations est inférieure à sizeof(NDIS_NIC_SWITCH_VF_PARAMETERS). NDIS définit les DONNÉES. METHOD_INFORMATION. BytesNeeded membre dans la structure NDIS_OID_REQUEST à la taille de mémoire tampon minimale requise.
NDIS_STATUS_INVALID_LENGTH	La mémoire tampon d’informations était trop courte. NDIS définit les DONNÉES. METHOD_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.