Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Der Protokollrand des Hyper-V erweiterbaren Switches gibt eine OID-Satzanforderung (Object Identifier) 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 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_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 der PropertyType Member auf NdisSwitchPortPropertyTypeVlanfestgelegt 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 das Hinzufügen der Porteigenschaft vetoieren, indem NDIS_STATUS_DATA_NOT_ACCEPTED für die OID-Anforderung zurückgegeben wird. Wenn eine Erweiterung z. B. keine Ressourcen zuordnen kann, um die konfigurierten Richtlinien für den Port zu erzwingen, sollte sie die Zusatzanforderung vetoieren.
Hinweis Wenn die Erweiterung andere NDIS_STATUS_Xxx Fehlerstatuscodes zurückgibt, wird die Erstellungsbenachrichtigung ebenfalls vetoiert. Das Zurückgeben von Statuscodes für transitory Szenarien, z. B. das Zurückgeben von NDIS_STATUS_RESOURCES, kann jedoch zu einer Wiederholung der Erstellungsbenachrichtigung führen.
Wenn die Erweiterung die OID-Anforderung nicht vetot, sollte der Status überwacht werden, wenn die Anforderung abgeschlossen ist. Die Erweiterung sollte dies tun, um zu bestimmen, ob die OID-Anforderung durch zugrunde liegende Erweiterungen im erweiterbaren Switch-Steuerungspfad oder über die erweiterbare Switchschnittstelle vetoed 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-Setanforderung von OID_SWITCH_PORT_PROPERTY_ADD abschließt, gibt sie einen der folgenden Statuscodes 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 fest. SET_INFORMATION. BytesNeededed Member in der NDIS_OID_REQUEST Struktur auf die erforderliche Mindestpuffergröße. |
NDIS_STATUS_DATA_NOT_ACCEPTED |
Die Weiterleitungserweiterung hat die Benachrichtigung zum Hinzufügen von Portrichtlinien vetoiert. |
NDIS_STATUS_NOT_SUPPORTED |
Die Weiterleitungserweiterung unterstützt die Portrichtlinie nicht. |
NDIS_STATUS_Xxx- |
Fehler bei der OID-Anforderung aus anderen Gründen. |
Wenn die Erweiterung die OID-Setanforderung von OID_SWITCH_PORT_PROPERTY_ADD nicht abschließt, wird die Anforderung durch den zugrunde liegenden Miniportrand des erweiterbaren Schalters abgeschlossen. Der Miniportrand 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_CUSTOM
NDIS_SWITCH_PORT_PROPERTY_PARAMETERS