NdisMGetVirtualFunctionLocation, fonction (ndis.h)
Un pilote miniport appelle la fonction NdisMGetVirtualFunctionLocation pour interroger l’emplacement d’un périphérique d’une fonction virtuelle (VF) PCI Express (PCIe) sur un bus PCI. Le pilote utilise l’emplacement du périphérique pour construire l’ID de demandeur (RID) PCIe pour la VF.
Syntaxe
void NdisMGetVirtualFunctionLocation(
[in] NDIS_HANDLE NdisMiniportHandle,
[in] NDIS_SRIOV_FUNCTION_ID VFId,
[out] PUSHORT SegmentNumber,
[out] PUCHAR BusNumber,
[out] PUCHAR FunctionNumber
);
Paramètres
[in] NdisMiniportHandle
Handle de carte réseau que NDIS a transmis au paramètre MiniportAdapterHandle de MiniportInitializeEx.
[in] VFId
Identificateur de la VF pour laquelle l’emplacement de l’appareil est retourné.
[out] SegmentNumber
Pointeur vers une variable fournie par l’appelant dans laquelle cette fonction retourne une valeur USHORT pour le numéro de segment PCI actuel. Cette valeur spécifie le groupe de bus PCI sur lequel l’appareil est attaché.
[out] BusNumber
Pointeur vers une variable fournie par l’appelant dans laquelle cette fonction retourne une valeur UCHAR. Cette valeur spécifie le numéro de bus PCI actuel auquel l’appareil est attaché.
[out] FunctionNumber
Pointeur vers une variable fournie par l’appelant dans laquelle cette fonction retourne une valeur UCHAR. Cette valeur spécifie le numéro de fonction d’un appareil logique sur l’appareil.
Valeur de retour
None
Remarques
Lorsqu’il gère une demande de méthode de OID_NIC_SWITCH_ALLOCATE_VF, le pilote PF miniport doit retourner le RID pour la VF que le pilote a correctement allouée sur la carte réseau. Le pilote génère le RID de la manière suivante :
- Le pilote appelle d’abord la fonction NdisMGetVirtualFunctionLocation pour obtenir les informations d’emplacement liées au bus pour la VF.
- Le pilote appelle ensuite la macro NDIS_MAKE_RID avec les informations d’emplacement liées au bus pour générer le RID.
Pour plus d’informations sur l’allocation de ressources VF, consultez Séquence d’initialisation de fonction virtuelle.
Pour plus d’informations sur l’interface SR-IOV, consultez Vue d’ensemble de la virtualisation d’E/S à racine unique (SR-IOV).
Interface avec un pilote de bus virtuel
Si un fournisseur de matériel indépendant (IHV) fournit un pilote de bus virtuel (VBD) dans le cadre de son package de pilotes SR-IOV, son pilote miniport ne doit pas appeler NdisMGetVirtualFunctionLocation. Au lieu de cela, le pilote doit s’interfacer avec le VBD via un canal de communication privé et demander au VBD d’appeler GetLocation. Cette fonction est exposée à partir de l’interface GUID_PCI_VIRTUALIZATION_INTERFACE prise en charge par le pilote de bus PCI sous-jacent.Le VBD qui s’exécute dans le système d’exploitation de gestion de la partition parente Hyper-V peut interroger l’interface GUID_PCI_VIRTUALIZATION_INTERFACE en émettant une demande de IRP_MN_QUERY_INTERFACE à son objet d’appareil physique (PDO) sur le bus PCI. Cette requête doit être effectuée à partir de IRQL = PASSIVE_LEVEL. Dans cette requête, le pilote doit définir le paramètre InterfaceType sur GUID_PCI_VIRTUALIZATION_INTERFACE.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Aucune prise en charge, prise en charge dans NDIS 6.30 et versions ultérieures. |
| Serveur minimal pris en charge | Windows Server 2012 |
| Plateforme cible | Universal |
| En-tête | ndis.h (inclure Ndis.h) |
| Bibliothèque | Ndis.lib |
| IRQL | PASSIVE_LEVEL |
Voir aussi