OID_SWITCH_PROPERTY_UPDATE
Hrana protokolu Hyper-V rozšiřitelného přepínače vydává požadavek na nastavení identifikátoru objektu (OID) OID_SWITCH_PROPERTY_UPDATE upozornit rozšíření rozšiřitelného přepínače o aktualizaci parametrů pro rozšiřitelnou vlastnost zásad přepínače.
InformationBuffer člen struktury NDIS_OID_REQUEST obsahuje ukazatel na vyrovnávací paměť. Tato vyrovnávací paměť obsahuje následující data:
Struktura NDIS_SWITCH_PROPERTY_PARAMETERS, která určuje identifikaci a typ rozšiřitelné zásady přepínače.
Vyrovnávací paměť vlastnosti, která obsahuje parametry pro rozšiřitelné zásady přepínače. Vyrovnávací paměť vlastnosti obsahuje strukturu, která je založena na PropertyType člen struktury NDIS_SWITCH_PROPERTY_PARAMETERS.
Poznámka Počínaje Windows Serverem 2012 musí být PropertyType člen nastaven na NdisSwitchPropertyTypeCustom a vyrovnávací paměť vlastnosti musí obsahovat NDIS_SWITCH_PROPERTY_CUSTOM strukturu.
Poznámky
Rozšíření předávání může zpracovat požadavek sady identifikátorů identifikátorů OID_SWITCH_PROPERTY_UPDATE. Všechny ostatní typy rozšíření musí volat NdisFOidRequest předat požadavek OID na další rozšíření v rozšiřitelném zásobníku ovladačů přepínače.
Rozšíření může provést aktualizaci vlastnosti switch 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í aktualizovaných zásad na přepínači, měl by se vetovat žádost o aktualizaci.
Poznámka 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.
Pokyny pro zpracování požadavku sady identifikátorů OID OID_SWITCH_PROPERTY_UPDATE najdete v tématu Správa zásad přepínače.
Návratové stavové kódy
Pokud rozšíření dokončí požadavek sady identifikátorů OID OID_SWITCH_PROPERTY_UPDATE, vrátí jeden z následujících stavových kódů.
| Stavový kód | Popis |
|---|---|
NDIS_STATUS_DATA_NOT_ACCEPTED |
Rozšíření vetovalo oznámení o aktualizaci zásad přepínače. |
NDIS_STATUS_FAILURE |
Požadavek OID selhal z jiných důvodů. |
Pokud rozšíření nedokončí požadavek sady OID OID_SWITCH_PROPERTY_UPDATE, žádost se dokončí podkladovým miniportovým okrajem rozšiřitelného přepínače. Okraj miniportu vrátí následující stavový kód.
| 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) |