Sdílet prostřednictvím


OID_NIC_SWITCH_CURRENT_CAPABILITIES

Přílišný ovladač vydá požadavek na dotaz identifikátoru objektu (OID) OID_NIC_SWITCH_CURRENT_CAPABILITIES k získání aktuálně povolených hardwarových funkcí přepínače síťové karty v síťovém adaptéru.

Po úspěšném návratu z požadavku dotazu OID obsahuje InformationBuffer člen struktury NDIS_OID_REQUEST obsahuje ukazatel na strukturu NDIS_NIC_SWITCH_CAPABILITIES.

Poznámky

Počínaje verzí NDIS 6.20 ovladače miniportu poskytují aktuálně povolené hardwarové funkce přepínače síťových adaptérů na síťovém adaptéru, když je volána jeho MiniportInitializeEx funkce. Ovladač inicializuje NDIS_NIC_SWITCH_CAPABILITIES strukturu s hardwarovými možnostmi přepínače síťových adaptérů a nastaví CurrentNicSwitchCapabilities člen struktury NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES na ukazatel na strukturu NDIS_NIC_SWITCH_CAPABILITIES. Ovladač miniportu pak zavolá funkci NdisMSetMiniportAttributes a nastaví parametr MiniportAttributes ukazatel na strukturu NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES.

Poznámka Počínaje verzí NDIS 6.30 musí ovladače miniportu, které podporují rozhraní virtualizace vstupně-výstupních operací (SR-IOV), zaregistrovat povolené hardwarové funkce přepínače síťové karty. Ovladače tyto funkce registrují voláním NdisMSetMiniportAttributes.

Přílišné ovladače protokolu a filtru nemusí vydávat požadavky na dotazy OID OID_NIC_SWITCH_CURRENT_CAPABILITIES. NDIS poskytuje aktuálně povolené hardwarové funkce přepínače síťových adaptérů pro tyto ovladače následujícím způsobem:

  • NDIS hlásí aktuálně povolené hardwarové možnosti přepínače síťových adaptérů základního síťového adaptéru tak, aby v NicSwitchCapabilities člen struktury NDIS_BIND_PARAMETERS během operace vazby.

  • NDIS hlásí aktuálně povolené hardwarové možnosti přepínače síťových adaptérů základního síťového adaptéru tak, aby překládaly ovladače filtru v NicSwitchCapabilities člen struktury NDIS_FILTER_ATTACH_PARAMETERS během operace připojení.

Návratové stavové kódy

NDIS zpracovává požadavek na dotaz OID požadavku OID_NIC_SWITCH_CURRENT_CAPABILITIES pro ovladače miniportu. Tento požadavek na identifikátor OID se nevystaví.

Když NDIS zpracovává požadavek OID_NIC_SWITCH_CURRENT_CAPABILITIES, vrátí jeden z následujících stavových kódů:

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 buď nepodporuje rozhraní jedno kořenové virtualizace vstupně-výstupních operací (SR-IOV), nebo není povoleno používat rozhraní.

NDIS_STATUS_INVALID_LENGTH

Délka vyrovnávací paměti informací je menší než velikost(NDIS_NIC_SWITCH_CAPABILITIES). Ovladač miniportu musí nastavit DATA. QUERY_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.20 a novějších verzích.

Záhlaví

Ntddndis.h (včetně Ndis.h)

Viz také

NDIS_BIND_PARAMETERS

NDIS_FILTER_ATTACH_PARAMETERS

NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES

NDIS_NIC_SWITCH_CAPABILITIES

NDIS_OID_REQUEST