DriverEntry Guidelines for PF Miniport Drivers
Cette rubrique décrit les instructions relatives à l’écriture d’une fonction DriverEntry pour le pilote miniport de la fonction physique 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.
La carte réseau SR-IOV doit implémenter un pont matériel qui transfère le trafic réseau sur le port physique de la carte et les ports virtuels internes (VPorts). Ce pont est appelé commutateur de carte réseau. Pour plus d’informations, consultez Commutateurs de carte réseau.
Si le pilote pf miniport prend en charge la création statique du commutateur de carte réseau sur la carte réseau SR-IOV, il peut avoir besoin d’allouer des ressources de commutateur lorsque l’objet de périphérique fonctionnel (FDO) est créé pour la carte réseau dans la pile de périphériques. Dans ce cas, le pilote doit allouer ces ressources avant que NDIS appelle MiniportInitializeEx. Pour ce faire, le pilote doit inscrire des gestionnaires Plug-and-Play (PnP) facultatifs afin qu’il puisse participer au processus lorsque le FDO de l’adaptateur est ajouté ou supprimé de la pile de périphériques.
Le pilote miniport doit fournir une fonction MiniportSetOptions pour inscrire ces fonctions de gestionnaire PnP. Pour ce faire, le pilote suit ces étapes à partir du contexte de l’appel à sa fonction DriverEntry :
Le pilote miniport initialise une structure NDIS_MINIPORT_DRIVER_CHARACTERISTICS avec les points d’entrée des fonctions MiniportXxx . En particulier, le pilote définit le membre SetOptionsHandler sur le point d’entrée de la fonction MiniportSetOptions du pilote.
Le pilote miniport appelle la fonction NdisMRegisterMiniportDriver pour inscrire ses points d’entrée. À partir du contexte de cet appel, NDIS appelle la fonction MiniportSetOptions du pilote
Lorsque NDIS appelle MiniportSetOptions, le pilote miniport appelle la fonction NdisSetOptionalHandlers et spécifie une structure NDIS_MINIPORT_PNP_CHARACTERISTICS . Cette structure définit les points d’entrée pour les fonctions MiniportAddDevice, MiniportRemoveDevice, MiniportStartDevice et MiniportFilterResourceRequirements . NDIS appelle ces fonctions de gestionnaire quand il gère les paquets de requête d’E/S PnP (IRP) émis par le pilote de bus PCI.
Si le pilote pf miniport doit allouer des ressources logicielles supplémentaires pour le commutateur de carte réseau avant que NDIS appelle la fonction MiniportInitializeEx du pilote, le pilote doit inscrire une fonction MiniportAddDevice . Lorsque NDIS appelle la fonction MiniportAddDevice, le pilote pf miniport peut appeler NdisReadConfiguration pour lire la configuration du commutateur de carte réseau mot clé les paramètres du Registre. Pour plus d’informations sur ces mots clés, consultez Mots clés INF standardisés pour SR-IOV.
Pour plus d’informations sur les instructions relatives à la fonction MiniportAddDevice , consultez Instructions miniportAddDevice pour les pilotes PF Miniport.
Pour plus d’informations sur la création des commutateurs de carte réseau, consultez Création d’un commutateur de carte réseau.