OID_SWITCH_PORT_CREATE

Hrana protokolu Hyper-V rozšiřitelného přepínače vydává požadavek na nastavení identifikátoru objektu (OID) OID_SWITCH_PORT_CREATE o upozornění rozšíření rozšiřitelného přepínače o vytvoření rozšiřitelného přepínače portu.

InformationBuffer člen struktury NDIS_OID_REQUEST obsahuje ukazatel na NDIS_SWITCH_PORT_PARAMETERS strukturu.

Poznámky

PortId člen struktury NDIS_SWITCH_PORT_PARAMETERS určuje port, pro který se oznámení o vytvoření provádí.

Rozšíření rozšiřitelného přepínače musí postupovat podle těchto pokynů pro zpracování požadavků sady identifikátorů OID_SWITCH_PORT_CREATE:

• Rozšíření nesmí upravovat NDIS_SWITCH_PORT_PARAMETERS strukturu přidruženou k požadavku OID.

• Rozšíření může provést oznámení o vytvoření vrácením NDIS_STATUS_DATA_NOT_ACCEPTED pro požadavek OID. Pokud například rozšíření nemůže přidělit prostředky k vynucení nakonfigurovaných zásad na portu, ovladač by měl provést oznámení o vytvoření.

  Pokud rozšíření vrátí další NDIS_STATUS_Xxx stavové kódy chyb, oznámení o vytvoření je také veto. Vrácení stavových kódů pro přechodné scénáře, jako je například vrácení NDIS_STATUS_RESOURCES, ale může způsobit opakování oznámení o vytvoření.

  Pokud rozšíření požadavek OID vetuje, měl by po dokončení požadavku monitorovat stav. Toto rozšíření by mělo provést, aby bylo možné určit, zda požadavek OID byl vetován podkladovými rozšířeními v rozšiřitelné cestě řízení přepínače nebo rozšiřitelným rozhraním přepínače.

  Další informace o zásadách portů najdete v tématu Správa Hyper-V Rozšiřitelné zásady přepínače.

• Pokud rozšíření volá NdisFOidRequest předat tento požadavek sady identifikátorů, rozšíření by mělo monitorovat stav dokončení tohoto požadavku OID. Toto rozšíření umožňuje zjistit, jestli podkladová rozšíření v zásobníku ovladačů rozšiřitelného přepínače vetovala oznámení o vytvoření portu.

• Po úspěšném předání a dokončení požadavku OID může rozšíření vydat žádosti OID pro port, jako je OID_SWITCH_PORT_PROPERTY_ENUM, dokud se nevystaví požadavek na identifikátor OID OID_SWITCH_PORT_TEARDOWN. Tento požadavek OID oznámí rozšíření, že port zahájí proces odstranění z rozšiřitelného přepínače.

• Rozšíření nemohou předávat pakety na zadaný port ve struktuře NDIS_SWITCH_PORT_PARAMETERS, dokud se nevystaví požadavek sady identifikátorů OID_SWITCH_NIC_CONNECT a úspěšně se dokončí.

Poznámka Rozšíření nesmí vydávat požadavky sady identifikátorů OID_SWITCH_PORT_CREATE.

Další informace o stavech rozšiřitelných portů přepínačů a připojení síťových adaptérů naleznete v tématu Hyper-V Rozšiřitelný přepínač a stavy síťových adaptérů.

Návratové stavové kódy

Pokud rozšíření dokončí požadavek sady identifikátorů OID OID_SWITCH_PORT_CREATE, vrátí jeden z následujících stavových kódů.

Stavový kód	Popis
NDIS_STATUS_DATA_NOT_ACCEPTED	Rozšíření vetlo oznámení o vytvoření.
NDIS_STATUS_RESOURCES	Rozšíření vetlo oznámení o vytvoření kvůli nízké podmínce prostředku.
NDIS_STATUS_Xxx	Rozšíření vytáhla oznámení o vytvoření z jiných důvodů.

Poznámka Pokud rozšíření dokončí požadavek sady identifikátorů, nesmí vrátit NDIS_STATUS_SUCCESS.

Pokud rozšíření nedokončí požadavek sady OID OID_SWITCH_PORT_CREATE, žádost se dokončí podkladovým miniportovým okrajem rozšiřitelného přepínače. Základní okraj miniportu vrátí následující stavový kód pro tento požadavek sady identifikátorů.

Stavový kód	Popis
NDIS_STATUS_SUCCESS	Požadavek OID byl úspěšně dokončen.

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_PARAMETERS

NdisFOidRequest

OID_SWITCH_NIC_CONNECT

OID_SWITCH_PORT_ARRAY

OID_SWITCH_PORT_PROPERTY_ENUM