OID_SWITCH_NIC_ARRAY

Rozšíření rozšiřitelného přepínače Hyper-V vydá žádost o dotaz identifikátor objektu (OID) OID_SWITCH_NIC_ARRAY k získání pole. Každý prvek v poli určuje parametry konfigurace virtuálního síťového adaptéru přidruženého k rozšiřitelnému portu přepínače.

Pokud se požadavek dotazu OID úspěšně dokončí, InformationBuffer člen struktury NDIS_OID_REQUEST obsahuje ukazatel na vyrovnávací paměť. Tato vyrovnávací paměť obsahuje následující data:

• Struktura NDIS_SWITCH_NIC_ARRAY, která definuje počet prvků v poli. Tato struktura také určuje posun na první prvek v poli.

• Pole NDIS_SWITCH_NIC_PARAMETERS struktur. Každá z těchto struktur obsahuje informace o síťovém adaptéru připojeném k rozšiřitelnému portu přepínače.

  Poznámka Pokud nejsou žádné síťové adaptéry připojeny k rozšiřitelným přepínačům, podkladová miniportová hrana rozšiřitelného přepínače nastaví NumElements člen struktury NDIS_SWITCH_NIC_ARRAY na nulu. V tomto případě se nevrací žádné NDIS_SWITCH_NIC_PARAMETERS struktury.

Poznámky

Identifikátor OID_SWITCH_NIC_ARRAY musí být vydán pouze v případech, kdy Hyper-V rozšiřitelný přepínač dokončil aktivaci. Další podrobnosti najdete v tématu Dotazování na konfigurace rozšiřitelného přepínače Hyper-V.

Když rozšíření zpracuje vrácenou NDIS_SWITCH_NIC_PARAMETERS strukturu, nesmí předpokládat, že různé řetězcové členy struktury NDIS_SWITCH_PORT_PARAMETERS, například NicFriendlyName, jsou ukončeny null. Datové typy pro tyto členy řetězců jsou definovány typem definovanou strukturou IF_COUNTED_STRING. Ovladač musí určit délku řetězce z hodnoty Délka člen této struktury.

Poznámka Pokud je řetězec ukončen s hodnotou null, nesmí Délka člen obsahovat ukončující znak null.

Návratové stavové kódy

Podkladová miniportová hrana rozšiřitelného přepínače dokončí požadavek dotazu OID OID_SWITCH_NIC_ARRAY a vrátí jeden z následujících stavových kódů.

Stavový kód	Popis
NDIS_STATUS_SUCCESS	Požadavek OID byl úspěšně dokončen.
NDIS_STATUS_INVALID_LENGTH	Délka vyrovnávací paměti informací je příliš malá, aby vrátila NDIS_SWITCH_NIC_ARRAY a její pole NDIS_SWITCH_NIC_PARAMETERS prvků. Podkladová miniportová hrana rozšiřitelného přepínače nastaví 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.30 a novějších verzích.
Záhlaví	Ntddndis.h (včetně Ndis.h)

Viz také

---

NDIS_OID_REQUEST

NDIS_SWITCH_NIC_ARRAY

NDIS_SWITCH_NIC_PARAMETERS

dotazování konfigurace rozšiřitelného přepínače Hyper-V