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 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 PCI Express (PCIe) sur une carte réseau. Seules les machines virtuelles qui ont des ressources allouées via une requête de méthode OID de OID_NIC_SWITCH_ALLOCATE_VF peuvent être interrogées via une requête de méthode OID de OID_NIC_SWITCH_VF_PARAMETERS.
NDIS gère la requête de méthode OID de OID_NIC_SWITCH_VF_PARAMETERS pour les pilotes miniport.
Lorsque la requête de méthode OID est effectuée, l'InformationBuffer membre de la structure NDIS_OID_REQUEST contient un pointeur vers une structure NDIS_NIC_SWITCH_VF_PARAMETERS.
Remarques
L’application en mode utilisateur ou pilote surchargé spécifie la machine virtuelle à interroger en définissant le VFId membre de la structure NDIS_NIC_SWITCH_VF_PARAMETERS sur l’identificateur de la fonction virtuelle. Le pilote ou l’application surlysant obtient l’identificateur VF de l’une des manières suivantes :
En émettant une requête 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 trop en mode utilisateur 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 VFId membre.
En émettant une requête de méthode OID de OID_NIC_SWITCH_ALLOCATE_VF.
Si cette demande OID est correctement effectuée, le pilote surchargé reçoit l’identificateur de la machine virtuelle nouvellement créée dans le VFId membre de la structure de NDIS_NIC_SWITCH_VF_PARAMETERS retournée.
Remarque Seuls les pilotes surlysants peuvent obtenir l’identificateur VF de cette façon.
Après un retour réussi à partir de la requête de méthode OID, l'InformationBuffer membre 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 pour 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 miniports et retourne le code d’état suivant pour les requêtes 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 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 le DATA. METHOD_INFORMATION. OctetsNeeded membre de 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 le DATA. METHOD_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 |
Prise en charge dans NDIS 6.30 et versions ultérieures. |
En-tête |
Ntddndis.h (include Ndis.h) |