Sdílet prostřednictvím


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)

Viz také


NDIS_OID_REQUEST

NDIS_SWITCH_PROPERTY_CUSTOM

NDIS_SWITCH_PROPERTY_PARAMETERS

NdisFOidRequest