Switchbeleid beheren

Hyper-V uitbreidbare filter- en doorstuuruitbreidingen kunnen worden ingericht met de eigenschappen van aangepaste switcheigenschappen. Zodra deze extensies zijn geconfigureerd, wordt het beleid afgedwongen wanneer zij de pakketten filteren die zijn verkregen op de gegevensinvoerpaden van de uitbreidbare switch. Zie Switch Policiesvoor meer informatie over deze beleidsregels.

De Hyper-V uitbreidbare switchinterface maakt gebruik van de volgende object-id's (OID's) voor het inrichten van filter- en doorstuuruitbreidingen met de eigenschappen van aangepaste switchbeleidsregels:

OID_SWITCH_PROPERTY_ADD
Deze OID-setaanvraag wordt uitgegeven door de protocolrand van de uitbreidbare switch om onderliggende extensies op de hoogte te stellen van de toevoeging van een eigenschap aan de WMI-beheerlaag. De InformationBuffer van de NDIS_OID_REQUEST structuur bevat een pointer naar een NDIS_SWITCH_PROPERTY_PARAMETERS structuur.

Opmerking aangepaste switcheigenschappen worden opgegeven door een NDIS_SWITCH_PROPERTY_TYPE opsommingswaarde van NdisSwitchPropertyTypeCustom.

OID_SWITCH_PROPERTY_UPDATE
Deze OID-setaanvraag wordt uitgegeven door de protocolinterface van de uitbreidbare schakelaar om onderliggende extensies van de update van een eigenschap op de WMI-beheerlaag op de hoogte te stellen. De InformationBuffer- van de NDIS_OID_REQUEST--structuur bevat een wijzer naar een NDIS_SWITCH_PROPERTY_PARAMETERS--structuur.

OID_SWITCH_PROPERTY_DELETE
Deze OID-setaanvraag wordt uitgegeven door de protocolrand van de uitbreidbare switch om onderliggende extensies op de hoogte te stellen van het verwijderen van een eigenschap op de WMI-beheerlaag. De InformationBuffer van de NDIS_OID_REQUEST-structuur bevat een aanwijzer naar een NDIS_SWITCH_PROPERTY_DELETE_PARAMETERS-structuur.

OID_SWITCH_PROPERTY_ENUM
Deze OID-methodeaanvraag wordt verzonden door de extensie om een query uit te voeren op de onderliggende minipoortrand van de uitbreidbare switch over de momenteel geconfigureerde switcheigenschappen op de uitbreidbare switch. De InformationBuffer- van de NDIS_OID_REQUEST-structuur bevat een aanwijzer naar een buffer. Deze buffer bevat de volgende gegevens:

• Een NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS structuur die de parameters voor de inventarisatie van eigenschappen van een switchbeleid aangeeft.

• Een matrix van NDIS_SWITCH_PROPERTY_ENUM_INFO structuren. Elk van deze structuren bevat informatie over de eigenschappen van een switchbeleid.

  Opmerking Als de NumProperties- lid van de NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS structuur is ingesteld op nul, worden er geen NDIS_SWITCH_PROPERTY_ENUM_INFO structuren geretourneerd.

Opmerking De extensie mag geen OID-setaanvragen van OID_SWITCH_PROPERTY_ADDuitvoeren. OID_SWITCH_PROPERTY_UPDATEof OID_SWITCH_PROPERTY_DELETE.

De uitbreiding voor uitbreidbare switch moet voldoen aan deze richtlijnen wanneer deze een OID-setaanvraag van OID_SWITCH_PROPERTY_ADD, OID_SWITCH_PROPERTY_UPDATEof OID_SWITCH_PROPERTY_DELETEverwerkt:

• De extensie mag de NDIS_SWITCH_PROPERTY_PARAMETERS of NDIS_SWITCH_PROPERTY_DELETE_PARAMETERS structuur die is gekoppeld aan de OID-aanvraag niet wijzigen.

• De extensie moet een OID_SWITCH_PROPERTY_UPDATE of OID_SWITCH_PROPERTY_DELETE setaanvraag verwerken als de extensie eerder is ingericht met een switcheigenschap die overeenkomt met de volgende leden van de NDIS_SWITCH_PROPERTY_PARAMETERS of NDIS_SWITCH_PROPERTY_DELETE_PARAMETERS structuur:

  • Het PropertyType lid dat het type switcheigenschap aangeeft.

    Opmerking Vanaf NDIS 6.30 worden alleen switcheigenschappen van NdisSwitchPropertyTypeCustom opgegeven door de NDIS_SWITCH_PROPERTY_PARAMETERS of NDIS_SWITCH_PROPERTY_DELETE_PARAMETERS structuren.

  • De PropertyId lid dat een eigen GUID-waarde opgeeft die door de extensie wordt herkend. Deze GUID-waarde wordt gemaakt door de onafhankelijke softwareleverancier (ISV) die ook de indeling van de aangepaste uitbreidbare switchbeleidseigenschap definieert.

    Opmerking Een aangepaste uitbreidbare switchbeleidseigenschap is bevat in een NDIS_SWITCH_PROPERTY_CUSTOM structuur.

• Als de extensie deze OID-setaanvragen verwerkt, moet de extensie het switchbeleid bijwerken of verwijderen dat overeenkomt met de volgende leden van de NDIS_SWITCH_PROPERTY_PARAMETERS-structuur:

  • Het PropertyVersion element waarmee de versie van het uitbreidbare switchbeleid wordt opgegeven.

  • Het PropertyInstanceId element dat het exemplaar van het uitbreidbare switchbeleid specificeert.

  Als de waarden van deze leden niet overeenkomen met een switchbeleidseigenschap waarvoor de extensie eerder is ingericht, moet de extensie mislukken bij de OID-setaanvraag met NDIS_STATUS_INVALID_PARAMETER. Anders moet de extensie de OID-setaanvraag voltooien en NDIS_STATUS_SUCCESS retourneren.

• De filter- of doorstuurextensie kan het toevoegen, verwijderen of bijwerken van een switchbeleid vetoeren. De extensie doet dit door de OID-aanvraag in te vullen met STATUS_DATA_NOT_ACCEPTED.

  Opmerking Capturerende extensies mogen de toevoeging of bijwerking van een switchbeleid niet vetoeren. In plaats daarvan moet de OID-aanvraag omlaag worden doorgestuurd naar het uitbreidbare schakeloptiepad.

• Als de opname- of filterextensie de OID-setaanvraag voor een aangepast switchbeleid verwerkt, mag deze de OID-aanvraag niet voltooien en moet deze doorsturen naar het uitbreidbare switchbesturingselementpad.

  Als de doorstuurextensie de OID-setaanvraag voor een aangepast switchbeleid verwerkt, moet deze de OID-aanvraag voltooien en de juiste NDIS_STATUS_Xxx waarde retourneren.

• Als de extensie de OID-setaanvraag niet voltooit, moet deze NdisFOidRequest aanroepen om de OID-aanvraag door te sturen naar de uitbreidbare switchstuurprogrammastack. In dit geval moeten de extensies de voltooiingsstatus van de OID controleren om te detecteren of een onderliggende extensie de OID-aanvraag heeft mislukt.