OID_SRIOV_VF_VENDOR_DEVICE_ID

Article
06/15/2023

Un pilote qui se superpose émet une demande de méthode d’identificateur d’objet (OID) de OID_SRIOV_VF_VENDOR_DEVICE_ID pour interroger l’identificateur de périphérique PCI Express (PCIe) (DeviceID) et l’identificateur de fournisseur (VendorID) pour une carte réseau PCI Express (PCIe) Virtual Function (VF). Cette carte réseau virtuelle est exposée dans la partition enfant Hyper-V attachée à la VF.

Les pilotes excessivement émettent cette demande de méthode OID au pilote miniport de la fonction physique (PF) PCI Express (PCIe) 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_SRIOV_VF_VENDOR_DEVICE_ID_INFO .

Notes

Avant d’exécuter cette demande de méthode OID, le pilote surchargé doit initialiser une structure de NDIS_SRIOV_VF_VENDOR_DEVICE_ID_INFO et doit définir le membre VFId sur l’identificateur de la VF à partir de laquelle les informations doivent être lues.

Lorsqu’il gère cette requête OID, le pilote pf miniport doit vérifier que la VF spécifiée contient des ressources qui ont été précédemment allouées. Le pilote pf miniport alloue des ressources pour une VF lors d’une demande de méthode OID de OID_NIC_SWITCH_ALLOCATE_VF. Si les ressources de la VF spécifiée n’ont pas été allouées, le pilote doit échouer dans la requête OID.

Pour plus d’informations, consultez Interrogation du fournisseur PCI et des identificateurs d’appareil pour une fonction virtuelle.

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_SRIOV_VF_VENDOR_DEVICE_ID.

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_SRIOV_VF_VENDOR_DEVICE_ID_INFO ont des valeurs non valides.
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.

Spécifications

Version	Pris en charge dans NDIS 6.30 et versions ultérieures.
En-tête	Ntddndis.h (inclure Ndis.h)

Voir aussi

NDIS_OID_REQUEST

NDIS_SRIOV_VF_VENDOR_DEVICE_ID_INFO

OID_NIC_SWITCH_ALLOCATE_VF