OID_NIC_SWITCH_VPORT_PARAMETERS

Článek
03/13/2025

Přílišný ovladač může získat parametry virtuálního portu (VPort) na přepínači síťové karty, který byl vytvořen na síťovém adaptéru, který podporuje virtualizaci jednoho kořenového V/V (SR-IOV). Ovladač vydá požadavek metody identifikátoru objektu (OID) OID_NIC_SWITCH_VPORT_PARAMETERS k získání těchto parametrů.

Přílišné ovladače vydávají požadavek sady identifikátorů OID_NIC_SWITCH_VPORT_PARAMETERS pro nastavení konfiguračních parametrů zadaného portu VPort připojeného k přepínači síťového adaptéru síťového adaptéru. Tyto požadavky sady identifikátorů se vydávají pro ovladač miniportu fyzické funkce PCI Express (PCIe) síťového adaptéru (PF). Tyto požadavky sady identifikátorů jsou vyžadovány 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 NDIS_NIC_SWITCH_VPORT_PARAMETERS strukturu.

Nadlimitní ovladač určuje VPort pro metodu OID nebo nastavit požadavek nastavením VPortId člen struktury NDIS_NIC_SWITCH_VPORT_PARAMETERS identifikátor přidružený k VPort. Přílišný ovladač získá identifikátor VPort jedním z následujících způsobů:

Z předchozího požadavku metody OID OID_NIC_SWITCH_CREATE_VPORT.
Z předchozího požadavku metody OID OID_NIC_SWITCH_ENUM_VPORTS.

Poznámky

OID_NIC_SWITCH_VPORT_PARAMETERS lze použít v požadavky metody OID nebo OID nastavit požadavky.

zpracování požadavků metody OID OID_NIC_SWITCH_VPORT_PARAMETERS

Nadměrné ovladače vydávají žádost o metodu OID OID_NIC_SWITCH_VPORT_PARAMETERS za účelem dotazování aktuálních parametrů konfigurace portu VPort připojeného k přepínači síťového adaptéru síťového adaptéru. Overlying drivers specify the VPort to query by setting the VPortId člen of the NDIS_NIC_SWITCH_VPORT_PARAMETERS structure to the VPort identifier.

NDIS zpracovává požadavek metody OID OID_NIC_SWITCH_VPORT_PARAMETERS pro ovladače miniportu. NDIS vrátí informace, které získal z předchozích požadavků identifikátorů identifikátorů OID_NIC_SWITCH_CREATE_VPORT a OID_NIC_SWITCH_ENUM_VPORTS.

Po úspěšném návratu z požadavku metody OID obsahuje InformationBuffer člen struktury NDIS_OID_REQUEST obsahuje ukazatel na strukturu NDIS_NIC_SWITCH_VPORT_PARAMETERS. Tato struktura obsahuje parametry konfigurace pro zadaný přepínač.

Další informace naleznete v tématu dotazování parametrů virtuálního portu.

zpracování požadavků sady identifikátorů identifikátorů OID_NIC_SWITCH_VPORT_PARAMETERS

Overlying drivers issue an OID set request of OID_NIC_SWITCH_VPORT_PARAMETERS to change the current configuration parameters of a VPort that is attached to a network adapter's nic switch. Tento požadavek OID lze použít k aktualizaci parametrů pro výchozí i nedefault VPorts.

Pro VPort je možné změnit pouze omezenou podmnožinu parametrů konfigurace. Přílišný ovladač určuje parametr, který se má změnit nastavením následujících členů struktury NDIS_NIC_SWITCH_VPORT_PARAMETERS:

Člen VPortId je nastaven na identifikátor VPortu, jehož parametry budou změněny.
Příslušné příznaky NDIS_NIC_SWITCH_VPORT_PARAMETERS_Xxx_CHANGED jsou nastaveny v příznakech členu. Členy struktury NDIS_NIC_SWITCH_VPORT_PARAMETERS lze změnit pouze v případě, že je v ntddndis.h definován odpovídající příznak NDIS_NIC_SWITCH_PARAMETERS_Xxx_CHANGED.
Odpovídající členy struktury NDIS_NIC_SWITCH_VPORT_PARAMETERS jsou nastaveny s konfiguračními parametry VPort, které se mají změnit.

Jakmile ovladač miniportu PF obdrží požadavek sady identifikátorů OID_NIC_SWITCH_VPORT_PARAMETERS, ovladač nakonfiguruje hardware s parametry konfigurace. Ovladač může změnit pouze tyto parametry konfigurace identifikované příznakem NDIS_NIC_SWITCH_VPORT_PARAMETERS_Xxx_CHANGED v Flags člen struktury NDIS_NIC_SWITCH_VPORT_PARAMETERS.

Další informace naleznete v tématu Nastavení parametrů virtuálního portu.

Návratové stavové kódy

Ovladač NDIS nebo miniport PF vrátí následující stavový kód pro požadavky set nebo metod OID OID_NIC_SWITCH_VPORT_PARAMETERS.

Stavový kód	Popis
NDIS_STATUS_SUCCESS	Žádost byla úspěšně dokončena. InformationBuffer odkazuje na strukturu NDIS_NIC_SWITCH_CAPABILITIES.
NDIS_STATUS_NOT_SUPPORTED	Ovladač miniportu PF buď nepodporuje rozhraní jedno kořenové virtualizace vstupně-výstupních operací (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	Informační vyrovnávací paměť byla příliš krátká. Ovladač NDIS nebo miniport PF nastaví DATA. METHOD_INFORMATION. BytesNeeded člen (pro požadavky metody OID) nebo DATA. SET_INFORMATION. BytesNeeded člen (pro požadavky sady identifikátorů) 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ů.