Freigeben über


OID_SWITCH_PORT_PROPERTY_ENUM

Die Hyper-V erweiterbaren Switcherweiterung gibt eine OID-Methodenanforderung (Object Identifier) von OID_SWITCH_PORT_PROPERTY_ENUM aus, um ein Array abzurufen. Dieses Array enthält die bereitgestellten Portrichtlinien, die den angegebenen Kriterien entsprechen. Jedes Element im Array gibt die Eigenschaften einer Richtlinie für einen angegebenen erweiterbaren Switchport an.

Das InformationBuffer Member der NDIS_OID_REQUEST-Struktur enthält einen Zeiger auf einen Puffer. Dieser Puffer enthält die folgenden Daten:

Bemerkungen

Bevor sie eine OID-Methodenanforderung von OID_SWITCH_PORT_PROPERTY_ENUM ausgibt, muss die erweiterbare Switcherweiterung die folgenden Richtlinien befolgen:

  • Die Erweiterung kann die OID_SWITCH_PORT_PROPERTY_ENUM Anforderung nur ausgeben, nachdem der Protokollrand des erweiterbaren Switches eine OID_SWITCH_PORT_CREATE Anforderung ausgibt und bevor eine OID_SWITCH_PORT_TEARDOWN Anforderung ausgibt.

  • Die Erweiterung muss ReferenceSwitchPort- aufrufen, bevor sie NdisFOidRequest- aufruft, um die OID_SWITCH_PORT_PROPERTY_ENUM Anforderung auszuweisen. Dadurch wird sichergestellt, dass der angegebene Port erst nach Abschluss der OID-Anforderung gelöscht wird.

    Nach Abschluss der OID-Anforderung muss die Erweiterung DereferenceSwitchPortaufrufen. Die Erweiterung muss diese Funktion aufrufen, unabhängig davon, ob die OID-Anforderung mit NDIS_STATUS_SUCCESS abgeschlossen wurde.

Das OID_SWITCH_PORT_PROPERTY_ENUM OID darf nur ausgegeben werden, wenn die aktivierung des Hyper-V erweiterbaren Schalters abgeschlossen ist. Weitere Informationen finden Sie unter Abfragen der Hyper-V Extensible Switch Configuration.

Hinweis Wenn die Erweiterung die OID-Methodenanforderung von OID_SWITCH_PORT_PROPERTY_ENUM empfängt, darf sie die OID-Anforderung nicht abschließen. Stattdessen muss NdisFOidRequest- aufgerufen werden, um die OID-Anforderung an den erweiterbaren Switchtreiberstapel weiterzuleiten.

Rückgabestatuscodes

Der zugrunde liegende Miniportrand des erweiterbaren Schalters schließt die OID-Abfrageanforderung von OID_SWITCH_PORT_PROPERTY_ENUM ab und gibt den folgenden Statuscode zurück.

Statuscode Beschreibung

NDIS_STATUS_SUCCESS

Die OID-Anforderung wurde erfolgreich abgeschlossen.

Anforderungen

Version

Unterstützt in NDIS 6.30 und höher.

Kopfball

Ntddndis.h (include Ndis.h)

Siehe auch


DereferenceSwitchPort

NDIS_OID_REQUEST

NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO

NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS

NdisFOidRequest

Abfragen der Hyper-V Extensible Switch Configuration

ReferenceSwitchPort-