OID_NIC_SWITCH_PARAMETERS
Přílišný ovladač vydá požadavek metody identifikátoru objektu (OID) OID_NIC_SWITCH_PARAMETERS k získání aktuálních parametrů konfigurace zadaného přepínače síťové karty na síťovém adaptéru. NDIS zpracovává tyto požadavky metody OID pro ovladač miniportu.
Přílišné ovladače vydávají požadavek sady identifikátorů OID OID_NIC_SWITCH_PARAMETERS pro nastavení parametrů konfigurace zadaného přepínače síťové karty na síťovém 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_PARAMETERS strukturu.
Přílišný ovladač určuje přepínač síťové karty pro metodu OID nebo nastavit požadavek nastavením SwitchId člen struktury NDIS_NIC_SWITCH_PARAMETERS na identifikátor přepínače. Přílišný ovladač získá identifikátor přepínače jedním z následujících způsobů:
Z předchozího požadavku metody OID OID_NIC_SWITCH_ENUM_SWITCHES.
Ze NicSwitchArray člen struktury NDIS_BIND_PARAMETERS. NDIS předá ukazatel na tuto strukturu v BindParameters parametr ProtocolBindAdapterEx funkce.
Ze NicSwitchArray člen struktury NDIS_FILTER_ATTACH_PARAMETERS. NDIS předává ukazatel na tuto strukturu v AttachParameters parametr FilterAttach funkce.
Poznámka Počínaje Windows Serverem 2012 podporuje Systém Windows pouze výchozí přepínač síťové karty na síťovém adaptéru. SwitchId člen struktury NDIS_NIC_SWITCH_PARAMETERS musí být nastaven na NDIS_DEFAULT_SWITCH_ID.
Poznámky
Přílišné problémy s ovladači OID_NIC_SWITCH_PARAMETERS požadavky následujícím způsobem:
Přílišný ovladač vydá požadavek metody OID OID_NIC_SWITCH_PARAMETERS získat aktuální parametry zadaného přepínače síťové karty. Další informace najdete v tématu Dotazování parametrů přepínače síťové karty.
Poznámka NDIS zpracovává požadavky metody OID OID_NIC_SWITCH_PARAMETERS pro ovladač miniport PF.
Přílišný ovladač vydá požadavek sady identifikátorů OID OID_NIC_SWITCH_PARAMETERS ke změně aktuálních parametrů zadaného přepínače síťové karty. Další informace naleznete v tématu Nastavení parametrů přepínače síťové karty.
Poznámka Ovladač miniportu PF zpracovává požadavky sady identifikátorů OID_NIC_SWITCH_PARAMETERS.
Návratové stavové kódy
Ovladač NDIS nebo miniport PF vrátí následující stavové kódy pro požadavky set nebo metod OID OID_NIC_SWITCH_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_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_REINIT_REQUIRED |
Ovladač miniportu PF vyžaduje opětovnou inicializaci síťového adaptéru, aby se změny použily na přepínač síťové karty. |
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) |