OID_NIC_SWITCH_ALLOCATE_VF
Un pilote qui se superpose émet une demande de méthode d’identificateur d’objet (OID) de OID_NIC_SWITCH_ALLOCATE_VF pour allouer des ressources pour une fonction virtuelle (VF) PCI Express (PCIe). La VF est exposée sur une carte réseau qui prend en charge l’interface de virtualisation d’E/S racine unique (SR-IOV).
Les pilotes sur-ment émettent cette demande de méthode OID au pilote miniport pour la fonction physique PCIe (PF) de la carte réseau. Cette demande de méthode OID est requise pour les pilotes pf miniport qui prennent en charge l’interface de virtualisation d’E/S racine unique (SR-IOV).
Le membre InformationBuffer de la structure NDIS_OID_REQUEST contient un pointeur vers une structure NDIS_NIC_SWITCH_VF_PARAMETERS .
Notes
Le pilote pf miniport alloue des ressources logicielles pour une VF lorsque le pilote gère une demande de méthode d’identificateur d’objet (OID) de OID_NIC_SWITCH_ALLOCATE_VF. Bien que les ressources matérielles aient été allouées pour une VF, elles sont considérées comme non opérantes tant que le pilote pf miniport n’a pas réussi l’OID_NIC_SWITCH_ALLOCATE_VF.
Pour plus d’informations sur l’allocation de ressources VF, consultez Allocation de ressources pour une fonction virtuelle.
Note Une fois qu’un pilote qui demande l’allocation de ressources pour une VF, ce pilote est le seul composant qui peut demander la libération des ressources pour la même VF. Le pilote qui se superpose doit émettre une demande d’ensemble OID de OID_NIC_SWITCH_FREE_VF pour libérer les ressources VF. Avant d’arrêter le pilote qui se trouve trop, il doit libérer les ressources pour chaque VF allouée par la demande de OID_NIC_SWITCH_ALLOCATE_VF du pilote.
Codes d’état de retour
Le pilote pf miniport renvoie l’un des codes status suivants pour la demande de méthode OID de OID_NIC_SWITCH_ALLOCATE_VF.
| Code d’état | Description |
|---|---|
NDIS_STATUS_SUCCESS |
La demande OID s’est terminée avec succès. |
NDIS_STATUS_NOT_SUPPORTED |
Le pilote pf 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). Le pilote pf miniport doit définir 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. |
Spécifications
Version |
Pris en charge dans NDIS 6.30 et versions ultérieures. |
En-tête |
Ntddndis.h (inclure Ndis.h) |