Instructions miniportInitializeEx pour les pilotes PF Miniport
Cette rubrique décrit les instructions relatives à l’écriture d’une fonction MiniportInitializeEx pour le pilote miniport de la fonction physique (PF) PCI Express (PCIe). Le pf est un composant d’une carte réseau qui prend en charge la virtualisation d’E/S racine unique (SR-IOV).
Note Ces recommandations s’appliquent uniquement aux conducteurs pf miniport. Pour obtenir des instructions d’initialisation pour le pilote miniport d’une fonction virtuelle PCIe (VF) de l’adaptateur, consultez Initialisation d’un pilote miniport VF.
Le pilote pf miniport suit les mêmes étapes que n’importe quel pilote miniport NDIS quand sa fonction MiniportInitializeEx . Pour plus d’informations sur ces étapes, consultez Initialisation d’un pilote Miniport.
En plus de ces étapes, le pilote pf miniport doit suivre ces étapes supplémentaires lorsque NDIS appelle la fonction MiniportInitializeEx du pilote :
Le pilote pf miniport appelle la fonction NdisGetHypervisorInfo pour vérifier qu’elle s’exécute dans la partition parente Hyper-V. Cette fonction retourne une structure NDIS_HYPERVISOR_INFO qui définit le type de partition. Si le type de partition est signalé sous la forme NdisHypervisorPartitionMsHvParent, le pilote miniport s’exécute dans la partition parente Hyper-V qui est attachée au pf sur l’adaptateur.
Note Si le type de partition est signalé sous la forme NdisHypervisorPartitionMsHvChild, le pilote miniport s’exécute dans la partition enfant Hyper-V qui est attachée à un VF sur l’adaptateur. Dans ce cas, le pilote miniport ne doit pas s’initialiser en tant que pilote PF. Si possible, le pilote doit s’initialiser en tant que pilote VF, comme décrit dans Initialisation d’un pilote VF Miniport.
Le pilote pf miniport doit lire les mots clés standardisés SR-IOV pour déterminer si SR-IOV est activé et obtenir les paramètres de configuration du commutateur de carte réseau. Pour plus d’informations sur ces mots clés, consultez Mots clés INF standardisés pour SR-IOV.
Note Si le pilote pf miniport a inscrit un point d’entrée à une fonction MiniportSetOptions , il a peut-être obtenu ces paramètres à partir du Registre lorsque NDIS a appelé MiniportSetOptions.
Si la carte réseau prend en charge SR-IOV, la file d’attente de machines virtuelles (VMQ) ou RSS, le pilote miniport doit déterminer la fonctionnalité à activer sur la carte réseau. Pour plus d’informations sur la façon de le déterminer, consultez Gestion des mots clés INF standardisés SR-IOV, VMQ et RSS.
En plus des fonctionnalités matérielles RSS et VMQ (si elles sont prises en charge), le pilote miniport doit signaler son ensemble complet de fonctionnalités matérielles SR-IOV. Ces fonctionnalités doivent être publiées indépendamment des paramètres de mot clé standardisés SR-IOV dans le Registre.
Si SR-IOV est activé sur la carte réseau, le pilote miniport doit également signaler les paramètres SR-IOV actuellement activés sur la carte.
Pour plus d’informations sur la création de rapports sur les fonctionnalités SR-IOV, consultez Détermination des fonctionnalités SR-IOV.
Le pilote miniport doit signaler son ensemble complet de fonctionnalités de commutateur de carte réseau matérielle. Ces fonctionnalités doivent être publiées indépendamment des paramètres de mot clé standardisés SR-IOV dans le Registre.
Si SR-IOV est activé sur la carte réseau, le pilote miniport doit également signaler les paramètres de commutateur de carte réseau actuellement activés sur la carte.
Pour plus d’informations sur la création de rapports sur les fonctionnalités de commutateur de carte réseau, consultez Détermination des fonctionnalités de commutateur de carte réseau.
Le pilote miniport doit signaler son ensemble complet de fonctionnalités de filtrage des réceptions matérielles. Ces fonctionnalités doivent être publiées indépendamment des paramètres de mot clé standardisés SR-IOV dans le Registre.
Si SR-IOV est activé sur la carte réseau, le pilote miniport doit également signaler les paramètres de filtrage de réception actuellement activés sur la carte.
Pour plus d’informations sur la création de rapports sur les fonctionnalités de filtrage de réception, consultez Détermination des fonctionnalités de filtrage de réception.
Si le pilote miniport prend en charge la création d’un commutateur de carte réseau statique, il doit effectuer les opérations suivantes dans le contexte de l’appel à MiniportInitializeEx.
Le pilote configure le matériel de l’adaptateur en fonction des paramètres de mot clé standardisés du commutateur de carte réseau. En fonction de ces paramètres, le pilote alloue les ressources matérielles et logicielles nécessaires pour le commutateur de carte réseau.
Le pilote miniport appelle NdisMEnableVirtualization pour activer SR-IOV et définir le nombre de machines virtuelles sur la carte réseau. Cette fonction configure la fonctionnalité étendue SR-IOV dans l’espace de configuration PCI de l’adaptateur. Si cette fonction retourne NDIS_STATUS_SUCCESS, SR-IOV est activé et les machines virtuelles sont exposées sur l’interface PCIe.
Pour plus d’informations, consultez Création statique d’un commutateur de carte réseau.
Note Si le pilote miniport prend en charge la création de commutateurs de carte réseau dynamique, il crée le commutateur et active la virtualisation lorsqu’il gère une demande de méthode d’identificateur d’objet (OID) de OID_NIC_SWITCH_CREATE_SWITCH. Pour plus d’informations, consultez Création dynamique d’un commutateur de carte réseau.