Vydávání žádostí OID_NIC_SWITCH_ALLOCATE_VF

Předtím než překrývající ovladač vydá ovladači miniportu požadavek metody identifikátoru objektu (OID) OID_NIC_SWITCH_ALLOCATE_VF pro fyzickou funkci PCI Express (PCIe) (PF), formátuje strukturu NDIS_NIC_SWITCH_VF_PARAMETERS. Tato struktura obsahuje parametry konfigurace pro prostředky, které mají být přiděleny pro virtuální funkci PCIe (VF) na síťovém adaptéru. Nadřazený ovladač musí nastavit členy této struktury následujícím způsobem:

• Člen SwitchId musí být nastaven na identifikátor přepínače NIC, který byl dříve vytvořen na síťovém adaptéru. Přepínač síťové karty se vytvoří prostřednictvím požadavku metody OID OID_NIC_SWITCH_CREATE_SWITCH.

  Když zpracovává požadavek metody OID OID_NIC_SWITCH_ALLOCATE_VF, miniportový ovladač pro fyzickou funkci PCIe (PF) přiděluje prostředky pro virtuální funkci (VF). Pokud jsou prostředky úspěšně přiděleny, ovladač miniportu PF přiřadí VF k zadanému přepínači síťové karty.

  Poznámka Počínaje verzí NDIS 6.30 ve Windows Serveru 2012 rozhraní SR-IOV podporuje pouze výchozí přepínač síťové karty na síťovém adaptéru. Hodnota členu SwitchId musí být nastavena na NDIS_DEFAULT_SWITCH_ID.

  Další informace o přepínači NIC viz přepínače síťových adaptérů.

• Člen VFId musí být nastaven na hodnotu NDIS_INVALID_VF_FUNCTION_ID.

• Člen RequestorId musí být nastaven na NDIS_INVALID_RID.

• Členy VMFriendlyName a VMName musí být nastaveny na parametry Hyper-V podřízeného oddílu. Ovladač miniportu PF používá tyto členy pouze pro informační účely.

  Poznámka Podřízený oddíl Hyper-V se také označuje jako virtuální počítač.

  VF je přidružen k zadanému VM předtím, než nadřazený ovladač vydá požadavek OID_NIC_SWITCH_CREATE_SWITCH.

• Člen NicName musí být nastaven na identifikátor síťového adaptéru virtuálního počítače. Tento virtuální adaptér je vystavený v hostovaném operačním systému, který běží na virtuálním počítači. Ovladač miniportu PF používá tento člen pouze pro informační účely.

  Pokud jsou prostředky přiděleny pro VF a je připojen k podřízenému oddílu, v hostovaném operačním systému se zobrazí síťový adaptér VF. Týmy síťových adaptérů virtuálních počítačů s síťovým adaptérem VF pro přenos paketů přes hardwarovou datovou cestu VF.

  VF je však možné odpojit od podřízeného oddílu, například během migrace za provozu. V takovém případě dojde k přenosu paketů přes softwarovou syntetickou cestu k datům. Další informace o těchto datových cestách najdete v tématu SR-IOV Cesty k datům.

• Členy PermanentMacAddress a CurrentMacAddress musí být nastaveny na adresy MAC (Media Access Control) pro virtuální síťový adaptér VF. Tyto adresy jsou vystaveny zásobníku sítě, který běží v hostovaném operačním systému Hyper-V podřízeného oddílu.

Přílišný ovladač vydává požadavek metody OID OID_NIC_SWITCH_ALLOCATE_VF pomocí následujícího postupu:

1. Nadřazený ovladač inicializuje strukturu NDIS_OID_REQUEST pro požadavek metody OID. Ovladač nastaví člen InformationBuffer na ukazatel na inicializovanou NDIS_NIC_SWITCH_VF_PARAMETERS strukturu.

2. Nadřazený ovladač volá NdisOidRequest, aby zadal požadavek OID na podkladový ovladač PF miniport.

   Poznámka Když nadlimitní ovladač volá NdisOidRequest, NDIS zachytí požadavek OID a ověří parametry VF zadané ve struktuře NDIS_NIC_SWITCH_VF_PARAMETERS . Pokud jsou parametry úspěšně ověřeny, NDIS předá identifikátor OID ovladači miniportu PF. Jinak NDIS odmítne požadavek OID s chybou NDIS_STATUS_INVALID_PARAMETER.

Jakmile nadlimitní ovladač požádá o přidělení prostředků pro VF, je tento ovladač jedinou komponentou, která může požádat o uvolnění prostředků pro stejný VF. Nadřazený ovladač musí vydat požadavek na nastavení identifikátoru OID_NIC_SWITCH_FREE_VF pro uvolnění prostředků VF. Než bude možné nadřazený ovladač zastavit, musí uvolnit prostředky pro každý VF, který byl přidělen žádostí ovladače OID_NIC_SWITCH_ALLOCATE_VF.