Inicializace ovladače miniportu VF

Toto téma popisuje pokyny pro psaní funkce MiniportInitializeEx pro ovladač miniportu pro virtuální funkci PCI Express (PCIe). VF je vystavený síťovým adaptérem, který podporuje virtualizaci jednoho kořenového V/V (SR-IOV).

Poznámka

 Tyto pokyny platí jenom pro ovladače miniportu VF síťového adaptéru SR-IOV. Pokud potřebujete pokyny pro inicializaci fyzické funkce PCIe (PF) adaptéru, naleznete je v tématu Inicializace ovladače PF Miniport. 

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

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

• Ovladač miniportu VF volá funkci NdisGetHypervisorInfo k ověření, že je spuštěný v podřízené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 NdisHypervisorPartitionMsHvChild, pak ovladač miniportu běží v Hyper-V podřízeném oddílu, který je připojen k PF na adaptéru.

  Poznámka

  Pokud je typ oddílu hlášen jako NdisHypervisorPartitionMsHvParent, ovladač miniportu běží v nadřazeném oddílu Hyper-V, který je připojen k PF adaptéru. V tomto případě se ovladač miniportu nesmí inicializovat jako ovladač VF. Pokud je to možné, ovladač musí být inicializován jako PF ovladač, jak je popsáno v Inicializační sekvence pro ovladače PF Miniport.

• Na rozdíl od ovladače miniportu PF nesmí být ovladač miniportu VF nainstalován s použitím standardizovaných klíčových slov SR-IOV a nesmí se pokoušet tato klíčová slova číst. Další informace o těchto klíčových slovech naleznete v tématu Standardizovaná INF klíčová slova pro SR-IOV.

• Ovladač miniportu VF hlásí hardwarové funkce SR-IOV základního virtuálního síťového adaptéru prostřednictvím struktury NDIS_SRIOV_CAPABILITIES, která se inicializuje následujícím způsobem:

  1. Ovladač miniportu inicializuje Header člen. Ovladač nastaví člena TypeHeader na NDIS_OBJECT_TYPE_DEFAULT.

     Počínaje verzí NDIS 6.30 nastaví miniportový ovladač člena Revize v záhlaví Header na NDIS_SRIOV_CAPABILITIES_REVISION_1 a člena Velikost na NDIS_SIZEOF_SRIOV_CAPABILITIES_REVISION_1.

  2. Ovladač miniportu nastaví příznak NDIS_SRIOV_CAPS_PF_MINIPORT v SriovCapabilities členu, aby oznámil možnosti SR-IOV.

     Poznámka

     Ovladač miniportu VF musí nastavit příznak NDIS_SRIOV_CAPS_VF_MINIPORT i příznak NDIS_SRIOV_CAPS_SRIOV_SUPPORTED.

  Ovladač miniportu VF registruje možnosti SR-IOV síťového adaptéru pomocí následujících kroků:

  1. Ovladač miniportu inicializuje strukturu NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES.

     Ovladač miniportu nastaví členy HardwareSriovCapabilities a CurrentSriovCapabilities na ukazatel na dříve inicializovanou strukturu NDIS_SRIOV_CAPABILITIES.

  2. Ovladač volá NdisMSetMiniportAttributes a parametr MiniportAttributes nastaví na ukazatel na strukturu NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES.

• Ovladač miniportu VF nesmí inzerovat funkce fronty virtuálních počítačů (VMQ). Ovladač ale může inzerovat podporu pro jiné technologie NDIS, jako je řízení spotřeby a škálování na straně příjmu (RSS).

  Další informace o technologii RSS naleznete v tématu Škálování na straně příjmu dat.