OID_SWITCH_PORT_ARRAY

Rozšíření Hyper-V rozšiřitelného přepínače vydává požadavek na dotaz identifikátoru objektu (OID) OID_SWITCH_PORT_ARRAY k získání pole. Každý prvek v poli určuje parametry konfigurace pro rozšiřitelný port 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_PORT_ARRAY, která definuje počet prvků v poli.

• Pole NDIS_SWITCH_PORT_PARAMETERS struktur. Každá z těchto struktur obsahuje informace o portu na rozšiřitelném přepínači.

  Poznámka Pokud nebyly na rozšiřitelném přepínači vytvořeny žádné porty, ovladač nastaví NumElements člen struktury NDIS_SWITCH_PORT_ARRAY na nulu a nevrací žádné struktury NDIS_SWITCH_PORT_PARAMETERS.

Poznámky

Identifikátor OID_SWITCH_PORT_ARRAY musí být vydán pouze při dokončení aktivace rozšiřitelného přepínače Hyper-V. Další podrobnosti najdete v tématu Dotazování na konfigurace rozšiřitelného přepínače Hyper-V.

Pokud rozšíření zpracovává vrácenou NDIS_SWITCH_PORT_PARAMETERS strukturu, nesmí předpokládat, že různé řetězcové členy struktury NDIS_SWITCH_PORT_PARAMETERS, například PortName, 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

Základní miniportový okraj rozšiřitelného přepínače dokončí požadavek dotazu OID OID_SWITCH_PORT_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 se vrátil NDIS_SWITCH_PORT_ARRAY a jeho pole NDIS_SWITCH_PORT_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_PORT_ARRAY

NDIS_SWITCH_PORT_PARAMETERS

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