OID_SWITCH_PROPERTY_UPDATE
De protocolrand van de Hyper-V uitbreidbare switch geeft een OID-setaanvraag (Object Identifier) van OID_SWITCH_PROPERTY_UPDATE om uitbreidbare switchextensies op de hoogte te stellen van de update naar parameters voor een uitbreidbare switchbeleidseigenschap.
De InformationBuffer lid van de NDIS_OID_REQUEST structuur bevat een aanwijzer naar een buffer. Deze buffer bevat de volgende gegevens:
Een NDIS_SWITCH_PROPERTY_PARAMETERS structuur die de identificatie en het type van een uitbreidbaar switchbeleid aangeeft.
Een eigenschapsbuffer die de parameters voor een uitbreidbaar switchbeleid bevat. De eigenschapsbuffer bevat een structuur die is gebaseerd op het PropertyType lid van de NDIS_SWITCH_PROPERTY_PARAMETERS-structuur.
Opmerking Vanaf Windows Server 2012 moet het PropertyType lid zijn ingesteld op NdisSwitchPropertyTypeCustom- en moet de eigenschapsbuffer een NDIS_SWITCH_PROPERTY_CUSTOM structuur bevatten.
Opmerkingen
Een doorstuurextensie kan de OID-setaanvraag van OID_SWITCH_PROPERTY_UPDATE verwerken. Alle andere typen extensies moeten NdisFOidRequest aanroepen om de OID-aanvraag door te sturen naar de volgende extensie in de uitbreidbare stuurprogrammastack van het switchstuurprogramma.
De extensie kan de update van de switcheigenschap vetoeren door NDIS_STATUS_DATA_NOT_ACCEPTED voor de OID-aanvraag te retourneren. Als een extensie bijvoorbeeld geen resources kan toewijzen om het bijgewerkte beleid op de switch af te dwingen, moet deze de updateaanvraag vetoeren.
Opmerking Als de extensie andere NDIS_STATUS_Xxx foutcodes retourneert, wordt de aanmaakmelding ook vetoed. Het retourneren van statuscodes voor tijdelijke scenario's, zoals het retourneren van NDIS_STATUS_RESOURCES, kan echter leiden tot een nieuwe poging om de melding voor het maken te maken.
Als de extensie de OID-aanvraag niet vetoeert, moet deze de status controleren wanneer de aanvraag is voltooid. De extensie moet dit doen om te bepalen of de OID-aanvraag is vetoed door onderliggende extensies in het uitbreidbare switchbesturingselementpad of door de uitbreidbare switchinterface.
Zie Beheer van switchbeleidsregelsvoor richtlijnen voor het afhandelen van een OID-setaanvraag van OID_SWITCH_PROPERTY_UPDATE.
Statuscodes retourneren
Als de extensie de OID-setaanvraag van OID_SWITCH_PROPERTY_UPDATE voltooit, wordt een van de volgende statuscodes geretourneerd.
| Statuscode | Beschrijving |
|---|---|
NDIS_STATUS_DATA_NOT_ACCEPTED |
De extensie heeft de melding voor het overschakelen van beleidsupdate vetoed. |
NDIS_STATUS_FAILURE |
De OID-aanvraag is om andere redenen mislukt. |
Als de extensie de OID-setaanvraag van OID_SWITCH_PROPERTY_UPDATE niet voltooit, wordt de aanvraag voltooid door de onderliggende minipoortrand van de uitbreidbare switch. De minipoortrand retourneert de volgende statuscode.
| Statuscode | Beschrijving |
|---|---|
NDIS_STATUS_SUCCESS |
De OID-aanvraag is voltooid. |
Eisen
Versie |
Ondersteund in NDIS 6.30 en hoger. |
Rubriek |
Ntddndis.h (inclusief Ndis.h) |