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:
Eine NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS Struktur, die die Parameter für die Richtlinienaufzählung eines angegebenen Ports angibt.
Ein Array von NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO Strukturen. Jede dieser Strukturen enthält Informationen zu den Eigenschaften einer erweiterbaren Switchportrichtlinie.
Hinweis Wenn das NumProperties-Element der NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS-Struktur auf Null festgelegt ist, werden keine NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO Strukturen zurückgegeben.
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
NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO
NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS