Pokyny pro MiniportInitializeEx pro ovladače PF Miniport

Toto téma popisuje pokyny pro psaní funkce MiniportInitializeEx pro miniportový ovladač fyzické funkce PCI Express (PCIe). PF je komponenta síťového adaptéru, který podporuje virtualizaci jednoho kořenového V/V (SR-IOV).

Poznámka Tyto pokyny platí pouze pro ovladače miniportu PF. Pokyny pro inicializaci ovladače miniportu pro virtuální funkci PCIe (VF) adaptéru najdete v tématu Inicializace ovladače miniportu VF.

Ovladač miniportu PF se řídí stejným postupem jako jakýkoli ovladač miniportu NDIS, když je volána jeho funkce MiniportInitializeEx. Další informace o těchto krocích naleznete v tématu Inicializace ovladače miniportu.

Kromě těchto kroků musí ovladač miniportu PF postupovat podle těchto dalších kroků, když NDIS volá funkci ovladače MiniportInitializeEx:

1. Ovladač miniportu PF volá funkci NdisGetHypervisorInfo k ověření, že je spuštěný v nadřazeném oddílu Hyper-V. Tato funkce vrátí NDIS_HYPERVISOR_INFO strukturu, která definuje typ oddílu. Pokud je typ oddílu hlášen jako NdisHypervisorPartitionMsHvParent, ovladač miniportu běží v Hyper-V nadřazeném oddílu, který je připojený k PF na adaptéru.

   Poznámka Pokud je typ oddílu hlášen jako NdisHypervisorPartitionMsHvChild, ovladač miniportu běží v Hyper-V podřízeném oddílu, který je připojený k VF na adaptéru. V tomto případě nesmí ovladač miniportu inicializovat jako ovladač PF. Pokud je to možné, ovladač se musí inicializovat jako ovladač VF, jak je popsáno v Inicializace ovladače miniportu VF.

2. Ovladač miniportu PF musí číst standardizované klíčové slova SR-IOV, aby zjistil, zda je povoleno SR-IOV, a získal nastavení konfigurace přepínače síťové karty. Další informace o těchto klíčových slovech naleznete viz Standardizovaná INF klíčová slova pro SR-IOV.

   Poznámka Pokud ovladač miniportu PF zaregistroval vstupní bod do funkce MiniportSetOptions, mohla být tato nastavení již dříve získána z registru při volání funkce NDIS MiniportSetOptions.

3. Pokud síťový adaptér podporuje SR-IOV, frontu virtuálních počítačů (VMQ) nebo RSS, musí ovladač miniportu určit, která funkce se má na síťovém adaptéru povolit. Další informace o tom, jak to zjistit, naleznete v tématu Zpracování SR-IOV, VMQ a RSS standardizovaných klíčových slov INF.

4. Spolu s hardwarovými možnostmi RSS a VMQ (pokud jsou podporovány), musí ovladač miniportu hlásit celou sadu hardwarových možností SR-IOV. Tyto funkce musí být inzerovány bez ohledu na SR-IOV standardizované nastavení klíčových slov v registru.

   Pokud je na síťovém adaptéru povolena SR-IOV, musí ovladač miniportu také hlásit aktuálně povolená nastavení SR-IOV na adaptéru.

   Další informace o zprávu o možnostech SR-IOV najdete v tématu Určení možností SR-IOV.

5. Ovladač miniportu musí hlásit úplnou sadu schopností hardwarového síťového přepínače. Tyto funkce musí být inzerovány bez ohledu na SR-IOV standardizované nastavení klíčových slov v registru.

   Pokud je na síťovém adaptéru povolená SR-IOV, musí ovladač miniportu také hlásit nastavení aktuálně použitelného přepínače síťové karty na adaptéru.

   Další informace o možnostech přepínače síťové karty najdete v tématu Určení možností přepínače síťové karty.

6. Ovladač miniportu musí hlásit celou sadu možností filtrování příjmu hardwaru. Tyto funkce musí být inzerovány bez ohledu na SR-IOV standardizované nastavení klíčových slov v registru.

   Pokud je na síťovém adaptéru povolená SR-IOV, musí ovladač miniportu také hlásit aktuálně povolené nastavení filtrování příjmu na adaptéru.

   Pro více informací o hlášení schopností filtrování příjmu viz Určení schopností filtrování příjmu.

7. Pokud ovladač miniportu podporuje vytvoření statického přepínače síťové karty, musí to provést v kontextu funkce volání MiniportInitializeEx.

   • Ovladač nakonfiguruje hardware adaptéru na základě standardizovaného nastavení klíčových slov přepínače síťové karty. Na základě těchto nastavení ovladač přidělí potřebné hardwarové a softwarové prostředky pro přepínač síťové karty.

   • Ovladač miniportu volá NdisMEnableVirtualization povolit SR-IOV a nastavit počet virtuálních souborů v síťovém adaptéru. Tato funkce konfiguruje v prostoru konfigurace PCI adaptéru rozšířenou možnost SR-IOV. Pokud tato funkce vrátí NDIS_STATUS_SUCCESS, SR-IOV je povolená a soubory VFS se zveřejňují přes rozhraní PCIe.

   Další informace naleznete v tématu Statické vytvoření přepínače NIC.

   Poznámka Pokud ovladač miniportu podporuje dynamické vytvoření přepínače síťové karty, vytvoří přepínač a povolí virtualizaci, když zpracovává požadavek metody identifikátoru objektu (OID) OID_NIC_SWITCH_CREATE_SWITCH. Další informace naleznete v tématu dynamické vytváření přepínače síťové karty.