OID_NIC_SWITCH_CREATE_VPORT
Přílišný ovladač vydá požadavek na metodu identifikátoru objektu (OID) OID_NIC_SWITCH_CREATE_VPORT k vytvoření nedefaultního virtuálního portu (VPort) na přepínači síťového adaptéru síťového adaptéru. Tento požadavek metody OID také připojí vytvořený VPort k fyzické funkci PCI Express (PCIe) síťového adaptéru (PF) nebo dříve přidělené virtuální funkci PCIe (VF).
Overlying drivers issue this OID method request to the miniport driver for the network adapter's PF. Tento požadavek na metodu OID je vyžadován pro ovladače miniportu PF, které podporují rozhraní jedno kořenové virtualizace vstupně-výstupních operací (SR-IOV).
InformationBuffer člen struktury NDIS_OID_REQUEST obsahuje ukazatel na strukturu NDIS_NIC_SWITCH_VPORT_PARAMETERS.
Poznámky
Přílišný ovladač inicializuje strukturu NDIS_NIC_SWITCH_VPORT_PARAMETERS s konfiguračními informacemi o nedefault VPort, který se má vytvořit. Informace o konfiguraci zahrnují funkci PCIe, ke které je připojen nedefault VPort, a počet párů front pro nedefault VPort.
Při vydání ovladače PF miniport OID požadavek, ovladač přidělí hardwarové a softwarové prostředky přidružené k zadané nondefault VPort. Po úspěšném přidělení všech prostředků ovladač miniportu PF úspěšně dokončí identifikátor OID vrácením NDIS_STATUS_SUCCESS z MiniportOidRequest.
Pokud se požadavek OID_NIC_SWITCH_CREATE_VPORT úspěšně dokončí, musí ovladač miniportu PF a nadlimitní ovladač zachovat VPortId hodnotu nedefaultního VPortu pro následné operace. Hodnota VPortId se používá během těchto operací:
NDIS a nadměrné ovladače používají hodnotu VPortId k identifikaci nevěrných VPort v následných požadavcích OID souvisejících s tímto VPortem, jako jsou OID_NIC_SWITCH_VPORT_PARAMETERS a OID_NIC_SWITCH_DELETE_VPORT.
Během operací odesílání určuje identifikátor NDIS hodnotu VPortId k identifikaci VPortu, ze kterého byl paket odeslán. Tato hodnota je určena v rámci mimosílových dat (OOB) NDIS_NET_BUFFER_LIST_FILTERING_INFO struktury NET_BUFFER_LIST.
Během operací příjmu určuje ovladač miniportu PF hodnotu VPortId, do které se má paket předávat. Tato hodnota je také určena v OOB NDIS_NET_BUFFER_LIST_FILTERING_INFO data struktury NET_BUFFER_LIST.
Další informace naleznete v tématu Vytvoření virtuálního portu.
Poznámka Výchozí VPort vždy existuje a není vytvořen, i když požadavek OID OID_NIC_SWITCH_CREATE_VPORT. Výchozí VPort má identifikátor NDIS_DEFAULT_VPORT_ID. Když ovladač miniportu PF vytvoří přepínač síťové karty, ovladač automaticky připojí výchozí VPort k PF síťového adaptéru.
Návratové stavové kódy
Ovladač NDIS nebo miniport PF vrátí jeden z následujících stavových kódů pro požadavek metody OID OID_NIC_SWITCH_CREATE_SWITCH.
Stavový kód | Popis |
---|---|
NDIS_STATUS_SUCCESS |
Požadavek OID byl úspěšně dokončen. |
NDIS_STATUS_NOT_SUPPORTED |
Ovladač miniportu PF nepodporuje rozhraní SR-IOV nebo není povoleno používat rozhraní. |
NDIS_STATUS_INVALID_PARAMETER |
Nejméně jeden člen struktury NDIS_NIC_SWITCH_VPORT_PARAMETERS má neplatné hodnoty. |
NDIS_STATUS_INVALID_LENGTH |
Délka vyrovnávací paměti informací je menší než velikost(NDIS_NIC_SWITCH_VPORT_PARAMETERS). Ovladač miniportu PF musí nastavit DATA. METHOD_INFORMATION. BytesNeeded člen ve struktuře NDIS_OID_REQUEST na minimální požadovanou velikost vyrovnávací paměti. |
NDIS_STATUS_FAILURE |
Žádost se nezdařila z jiných důvodů. |
Požadavky
Verze |
Podporováno v NDIS 6.30 a novějších verzích. |
Záhlaví |
Ntddndis.h (včetně Ndis.h) |