Sdílet prostřednictvím


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í:

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)

Viz také


MiniportOidRequest

NDIS_NIC_SWITCH_PARAMETERS

NDIS_NIC_SWITCH_VPORT_PARAMETERS

NDIS_OID_REQUEST

NET_BUFFER_LIST

OID_NIC_SWITCH_ALLOCATE_VF

OID_NIC_SWITCH_DELETE_VPORT

OID_NIC_SWITCH_PARAMETERS

OID_NIC_SWITCH_VPORT_PARAMETERS