OID_SWITCH_PORT_PROPERTY_ENUM

Artikel
03/13/2025

De Hyper-V uitbreidbare switchextensie geeft een OID-methodeaanvraag (Object Identifier) van OID_SWITCH_PORT_PROPERTY_ENUM om een matrix te verkrijgen. Deze matrix bevat het ingerichte poortbeleid dat voldoet aan de opgegeven criteria. Elk element in de matrix specificeert de eigenschappen van een beleid voor een opgegeven uitbreidbare switchpoort.

De InformationBuffer lid van de NDIS_OID_REQUEST structuur bevat een aanwijzer naar een buffer. Deze buffer bevat de volgende gegevens:

Een NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS structuur waarmee de parameters voor de beleidsinventarisatie van een opgegeven poort worden opgegeven.
Een matrix van NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO structuren. Elk van deze structuren bevat informatie over de eigenschappen van een uitbreidbaar switchpoortbeleid.

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

Opmerkingen

Voordat er een OID-methodeaanvraag van OID_SWITCH_PORT_PROPERTY_ENUM wordt uitgevoerd, moet de uitbreiding voor uitbreidbare switch de volgende richtlijnen volgen:

De extensie kan alleen de OID_SWITCH_PORT_PROPERTY_ENUM aanvraag uitgeven nadat de protocolrand van de uitbreidbare switch een OID_SWITCH_PORT_CREATE aanvraag heeft en voordat er een OID_SWITCH_PORT_TEARDOWN aanvraag wordt uitgevoerd.
De extensie moet ReferenceSwitchPort aanroepen voordat NdisFOidRequest wordt aangeroepen om de OID_SWITCH_PORT_PROPERTY_ENUM aanvraag uit te geven. Dit zorgt ervoor dat de opgegeven poort pas wordt verwijderd nadat de OID-aanvraag is voltooid.

Nadat de OID-aanvraag is voltooid, moet de extensie DereferenceSwitchPortaanroepen. De extensie moet deze functie aanroepen, ongeacht of de OID-aanvraag is voltooid met NDIS_STATUS_SUCCESS.

De OID_SWITCH_PORT_PROPERTY_ENUM OID mag alleen worden uitgegeven wanneer de Hyper-V uitbreidbare switch is geactiveerd. Zie query's uitvoeren op de Hyper-V Uitbreidbare switchconfiguratie voor meer informatie.

Opmerking Als de extensie de aanvraag van de OID-methode van OID_SWITCH_PORT_PROPERTY_ENUM ontvangt, mag deze de OID-aanvraag niet voltooien. In plaats daarvan moet deze NdisFOidRequest aanroepen om de OID-aanvraag door te sturen naar de uitbreidbare stack van het switchstuurprogramma.

Statuscodes retourneren

De onderliggende minipoortrand van de uitbreidbare switch voltooit de OID-queryaanvraag van OID_SWITCH_PORT_PROPERTY_ENUM en retourneert de volgende statuscode.