OID_NIC_SWITCH_CREATE_SWITCH

Článek
03/13/2025

NDIS vydává žádost o metodu identifikátoru objektu (OID) OID_NIC_SWITCH_CREATE_SWITCH k vytvoření přepínače síťové karty na síťovém adaptéru. Při zpracování tohoto požadavku OID ovladač miniportu přidělí prostředky pro přepínač síťové karty na adaptéru.

NDIS vydává tuto žádost o metodu OID pro ovladač miniportu fyzické funkce PCI Express (PCIe) síťového adaptéru (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).

Poznámka: Přílišné ovladače, jako jsou ovladače protokolu nebo filtru, nemůžou vydávat žádosti o metody OID OID_NIC_SWITCH_CREATE_SWITCH ovladači PF miniportu.

InformationBuffer člen struktury NDIS_OID_REQUEST obsahuje ukazatel na NDIS_NIC_SWITCH_PARAMETERS strukturu.

Poznámky

Když obdrží požadavek metody OID OID_NIC_SWITCH_CREATE_SWITCH, musí ovladač miniportu PF provést následující:

Pokud ovladač miniportu PF podporuje vytvoření a konfiguraci statického přepínače, vytvoří přepínač síťové karty při volání NDIS MiniportInitializeEx. Když ovladač zpracovává tento požadavek OID, musí ověřit parametry konfigurace ve struktuře NDIS_NIC_SWITCH_PARAMETERS. Parametry musí být stejné jako parametry používané ovladačem k vytvoření přepínače během volání MiniportInitializeEx. Pokud to není pravda, ovladač musí požadavek OID selhat.

Další informace naleznete v tématu Statické vytvoření přepínače síťové karty.
Pokud ovladač miniportu PF podporuje vytváření a konfiguraci dynamického přepínače, musí ovladač ověřit hodnoty konfigurace struktury NDIS_NIC_SWITCH_PARAMETERS a vytvořit přepínač síťové karty na základě těchto hodnot.

Další informace naleznete v tématu dynamické vytváření přepínače síťové karty.
Ovladač miniportu PF musí přidělit potřebné hardwarové a softwarové prostředky pro výchozí VPort na přepínači síťové karty.

Poznámka Výchozí VPort je vždy vytvořen prostřednictvím požadavku OID OID_NIC_SWITCH_CREATE_SWITCH a odstraněn prostřednictvím požadavku OID OID_NIC_SWITCH_DELETE_SWITCH. Požadavky OID OID_NIC_SWITCH_CREATE_VPORT a OID_NIC_SWITCH_DELETE_VPORT se používají k vytvoření a odstranění nedefaultních virtuálníchportů na přepínači síťové karty.
Ovladač miniportu PF, který podporuje vytváření a konfiguraci dynamického přepínače, musí na přepínači povolit virtualizaci SR-IOV voláním NdisMEnableVirtualization. Toto volání nakonfiguruje člena NumVFs a VF Enable bit ve struktuře rozšířené schopnosti SR-IOV konfiguračního prostoru PCI Express (PCIe) adaptéru.

Další informace o prostoru konfigurace SR-IOV najdete ve specifikaci PCI-SIG virtualizace a sdílení vstupně-výstupních operací s jedním kořenovým adresářem a sdílením.

Poznámka Pokud ovladač miniportu PF podporuje vytvoření statického přepínače, povolí virtualizaci SR-IOV po vytvoření přepínače při MiniportInitializeEx je volána.

Pokud ovladač miniportu PF úspěšně dokončí požadavek metody OID OID_NIC_SWITCH_CREATE_SWITCH, může dojít k následujícímu:

VFs lze přidělit na přepínač síťové karty prostřednictvím požadavků metody OID OID_NIC_SWITCH_ALLOCATE_VF.
Nedefault VPorts lze vytvořit na síťovém přepínači prostřednictvím požadavků metody OID OID_NIC_SWITCH_CREATE_VPORT.

Další informace o zpracování tohoto požadavku OID naleznete v tématu Zpracování OID_NIC_SWITCH_CREATE_SWITCH požadavku.

Návratové stavové kódy

Ovladač miniportu 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_PARAMETERS má neplatné hodnoty.
NDIS_STATUS_INVALID_LENGTH	Délka vyrovnávací paměti informací je menší než velikost(NDIS_NIC_SWITCH_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ů.