OID_SWITCH_PORT_PROPERTY_ADD

Artikel
06/15/2023

Der Protokollrand des erweiterbaren Hyper-V-Switches stellt eine OID-Set-Anforderung von OID_SWITCH_PORT_PROPERTY_ADD aus, um erweiterbare Switcherweiterungen über das Hinzufügen einer Richtlinieneigenschaft für einen erweiterbaren Switchport zu benachrichtigen.

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_PARAMETERS Struktur, die die Identifizierung und den Typ von Parametern für eine Portrichtlinie angibt.
Ein Eigenschaftenpuffer, der die Parameter für eine Portrichtlinie enthält. Der Eigenschaftenpuffer enthält eine Struktur, die auf dem PropertyType-Member der NDIS_SWITCH_PORT_PROPERTY_PARAMETERS-Struktur basiert. Wenn beispielsweise das PropertyType-Element auf NdisSwitchPortPropertyTypeVlan festgelegt ist, enthält der Eigenschaftenpuffer eine NDIS_SWITCH_PORT_PROPERTY_VLAN-Struktur .

Bemerkungen

Eine Weiterleitungserweiterung kann die OID-Set-Anforderung von OID_SWITCH_PORT_PROPERTY_ADD verarbeiten. Alle anderen Arten von Erweiterungen müssen NdisFOidRequest aufrufen, um die OID-Anforderung an die nächste Erweiterung im erweiterbaren Switchtreiberstapel weiterzuleiten.

Die Erweiterung kann ein Veto gegen das Hinzufügen der Porteigenschaft einwenden, indem NDIS_STATUS_DATA_NOT_ACCEPTED für die OID-Anforderung zurückgegeben wird. Wenn eine Erweiterung beispielsweise keine Ressourcen zuweisen kann, um die konfigurierten Richtlinien für den Port zu erzwingen, sollte sie ein Veto gegen die Ergänzungsanforderung ausführen.

Hinweis Wenn die Erweiterung andere NDIS_STATUS_Xxx-Fehler status Codes zurückgibt, wird auch die Erstellungsbenachrichtigung vetoiert. Das Zurückgeben status Codes für Transitszenarien, z. B. die Rückgabe von NDIS_STATUS_RESOURCES, kann jedoch zu einem Wiederholungsversuch der Erstellungsbenachrichtigung führen.

Wenn die Erweiterung kein Veto gegen die OID-Anforderung einnimmt, sollte sie die status überwachen, wenn die Anforderung abgeschlossen ist. Die Erweiterung sollte dies tun, um zu bestimmen, ob die OID-Anforderung von zugrunde liegenden Erweiterungen im erweiterbaren Switchsteuerungspfad oder von der erweiterbaren Switchschnittstelle vetoiert wurde.

Richtlinien zum Behandeln einer OID-Satzanforderung von OID_SWITCH_PORT_PROPERTY_ADD finden Sie unter Verwalten von Portrichtlinien.

Rückgabestatuscodes

Wenn die Weiterleitungserweiterung die OID-Set-Anforderung von OID_SWITCH_PORT_PROPERTY_ADD abschließt, gibt sie einen der folgenden status-Codes zurück:

Statuscode	BESCHREIBUNG
NDIS_STATUS_INVALID_LENGTH	Die Länge des Informationspuffers ist zu klein, um die NDIS_SWITCH_PORT_PROPERTY_PARAMETERS Struktur und die Daten im Eigenschaftenpuffer der Struktur zu verarbeiten. Die Erweiterung legt die DATA-Datei fest. SET_INFORMATION. BytesNeed-Member in der NDIS_OID_REQUEST-Struktur auf die erforderliche Mindestpuffergröße.
NDIS_STATUS_DATA_NOT_ACCEPTED	Die Weiterleitungserweiterung hat ein Veto gegen die Benachrichtigung zum Hinzufügen der Portrichtlinie erhalten.
NDIS_STATUS_NOT_SUPPORTED	Die Weiterleitungserweiterung unterstützt die Portrichtlinie nicht.
NDIS_STATUS_Xxx	Die OID-Anforderung ist aus anderen Gründen fehlgeschlagen.

Wenn die Erweiterung die OID-Set-Anforderung von OID_SWITCH_PORT_PROPERTY_ADD nicht erfüllt, wird die Anforderung durch den zugrunde liegenden Miniportrand des erweiterbaren Switches abgeschlossen. Der Miniportrand gibt den folgenden status Code zurück: