OID_SWITCH_PORT_PROPERTY_ENUM

Artikel
06/15/2023

Die Erweiterbare Hyper-V-Switcherweiterung stellt 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-Element 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 0 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 ausstellen, nachdem der Protokollrand des erweiterbaren Switches eine OID_SWITCH_PORT_CREATE-Anforderung ausgibt und bevor sie eine OID_SWITCH_PORT_TEARDOWN-Anforderung ausgibt.
Die Erweiterung muss ReferenceSwitchPort aufrufen, bevor sie NdisFOidRequest aufruft, um die OID_SWITCH_PORT_PROPERTY_ENUM-Anforderung ausstellen zu können. Dadurch wird sichergestellt, dass der angegebene Port erst gelöscht wird, nachdem die OID-Anforderung abgeschlossen wurde.

Nachdem die OID-Anforderung abgeschlossen wurde, muss die Erweiterung DereferenceSwitchPort aufrufen. Die Erweiterung muss diese Funktion aufrufen, unabhängig davon, ob die OID-Anforderung mit NDIS_STATUS_SUCCESS abgeschlossen wurde.

Die OID_SWITCH_PORT_PROPERTY_ENUM OID darf nur ausgestellt werden, wenn die Aktivierung des erweiterbaren Hyper-V-Schalters abgeschlossen ist. Weitere Informationen finden Sie unter Abfragen der Hyper-V Extensible Switch-Konfiguration .

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 über den erweiterbaren Switchtreiberstapel weiterzuleiten.

Rückgabestatuscodes

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