OID_SWITCH_PROPERTY_UPDATE
Der Protokollrand des erweiterbaren Hyper-V-Switches gibt eine OID-Set-Anforderung (Object Identifier) von OID_SWITCH_PROPERTY_UPDATE aus, um erweiterbare Switcherweiterungen über die Aktualisierung von Parametern für eine erweiterbare Switch-Richtlinieneigenschaft zu benachrichtigen.
Der InformationBuffer-Member der NDIS_OID_REQUEST-Struktur enthält einen Zeiger auf einen Puffer. Dieser Puffer enthält die folgenden Daten:
Eine NDIS_SWITCH_PROPERTY_PARAMETERS-Struktur , die die Identifizierung und den Typ einer erweiterbaren Switchrichtlinie angibt.
Ein Eigenschaftenpuffer, der die Parameter für eine erweiterbare Switchrichtlinie enthält. Der Eigenschaftenpuffer enthält eine Struktur, die auf dem PropertyType-Member der NDIS_SWITCH_PROPERTY_PARAMETERS-Struktur basiert.
Hinweis Ab Windows Server 2012 muss das PropertyType-Element auf NdisSwitchPropertyTypeCustom festgelegt werden, und der Eigenschaftenpuffer muss eine NDIS_SWITCH_PROPERTY_CUSTOM-Struktur enthalten.
Bemerkungen
Eine Weiterleitungserweiterung kann die OID-Set-Anforderung von OID_SWITCH_PROPERTY_UPDATE 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 die Aktualisierung der switch-Eigenschaft einwenden, indem sie NDIS_STATUS_DATA_NOT_ACCEPTED für die OID-Anforderung zurückgibt. Wenn eine Erweiterung beispielsweise keine Ressourcen zuordnen kann, um ihre aktualisierten Richtlinien auf dem Switch zu erzwingen, sollte sie ein Veto gegen die Updateanforderung einwenden.
Hinweis Wenn die Erweiterung andere NDIS_STATUS_Xxx-Fehler status Codes zurückgibt, wird auch die Erstellungsbenachrichtigung vetoiert. Die Rückgabe status Codes für transitorische Szenarien, 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 eingibt, 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_PROPERTY_UPDATE finden Sie unter Verwalten von Switchrichtlinien.
Zurückgeben von Statuscodes
Wenn die Erweiterung die OID-Set-Anforderung von OID_SWITCH_PROPERTY_UPDATE abschließt, gibt sie einen der folgenden status Codes zurück.
| Statuscode | BESCHREIBUNG |
|---|---|
NDIS_STATUS_DATA_NOT_ACCEPTED |
Die Erweiterung hat ein Veto gegen die Benachrichtigung zum Aktualisieren der Switchrichtlinie erteilt. |
NDIS_STATUS_FAILURE |
Die OID-Anforderung ist aus anderen Gründen fehlgeschlagen. |
Wenn die Erweiterung die OID-Set-Anforderung von OID_SWITCH_PROPERTY_UPDATE nicht abschließt, wird die Anforderung durch den zugrunde liegenden Miniportrand des erweiterbaren Switches abgeschlossen. Der Miniportrand gibt den folgenden status Code zurück.
| Statuscode | BESCHREIBUNG |
|---|---|
NDIS_STATUS_SUCCESS |
Die OID-Anforderung wurde erfolgreich abgeschlossen. |
Requirements (Anforderungen)
Version |
Unterstützt in NDIS 6.30 und höher. |
Header |
Ntddndis.h (include Ndis.h) |