OID_SWITCH_PORT_CREATE

Artikel
06/15/2023

Der Protokollrand des erweiterbaren Hyper-V-Switches stellt eine OID-Set-Anforderung von OID_SWITCH_PORT_CREATE aus, um erweiterbare Switcherweiterungen über die Erstellung eines erweiterbaren Switchports zu benachrichtigen.

Das InformationBuffer-Element der NDIS_OID_REQUEST-Struktur enthält einen Zeiger auf eine NDIS_SWITCH_PORT_PARAMETERS-Struktur .

Bemerkungen

Das PortId-Element der NDIS_SWITCH_PORT_PARAMETERS-Struktur gibt den Port an, für den die Erstellungsbenachrichtigung erfolgt.

Die erweiterbare Switcherweiterung muss die folgenden Richtlinien für die Behandlung von OID-Satzanforderungen von OID_SWITCH_PORT_CREATE befolgen:

Die Erweiterung darf die NDIS_SWITCH_PORT_PARAMETERS Struktur, die der OID-Anforderung zugeordnet ist, nicht ändern.
Die Erweiterung kann ein Veto gegen die Erstellungsbenachrichtigung ausführen, 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 der Treiber ein Veto gegen die Erstellungsbenachrichtigung einwenden.

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.

Weitere Informationen zu Portrichtlinien finden Sie unter Verwalten von Hyper-V Extensible Switch-Richtlinien.
Wenn die Erweiterung NdisFOidRequest aufruft, um diese OID-Set-Anforderung weiterzuleiten, sollte die Erweiterung die Vervollständigung status dieser OID-Anforderung überwachen. Die Erweiterung tut dies, um zu erkennen, ob zugrunde liegende Erweiterungen im erweiterbaren Switchtreiberstapel ein Veto gegen die Porterstellungsbenachrichtigung erhalten haben.
Nachdem die OID-Anforderung weitergeleitet und erfolgreich abgeschlossen wurde, kann die Erweiterung OIDs-Anforderungen für den Port ausstellen, z. B. OID_SWITCH_PORT_PROPERTY_ENUM, bis eine OID-Anforderung von OID_SWITCH_PORT_TEARDOWN ausgestellt wird. Diese OID-Anforderung benachrichtigt die Erweiterung, dass der Port den Löschvorgang über den erweiterbaren Switch beginnt.
Erweiterungen können Keine Pakete an den angegebenen Port in der NDIS_SWITCH_PORT_PARAMETERS-Struktur weiterleiten, bis eine OID-Satzanforderung von OID_SWITCH_NIC_CONNECT ausgegeben und erfolgreich abgeschlossen wurde.

Hinweis Erweiterungen dürfen keine OID-Satzanforderungen von OID_SWITCH_PORT_CREATE ausgeben.

Weitere Informationen zum Status erweiterbarer Switchports und Netzwerkadapterverbindungen finden Sie unter Hyper-V Extensible Switch Port and Network Adapter States.

Rückgabestatuscodes

Wenn die Erweiterung die OID-Set-Anforderung von OID_SWITCH_PORT_CREATE 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 Erstellungsbenachrichtigung erhalten.
NDIS_STATUS_RESOURCES	Die Erweiterung hat ein Veto gegen die Erstellungsbenachrichtigung aufgrund einer geringen Ressourcenbedingung abgelehnt.
NDIS_STATUS_Xxx	Die Erweiterung hat aus anderen Gründen ein Veto gegen die Erstellungsbenachrichtigung abgelehnt.

Hinweis Wenn die Erweiterung die OID-Setanforderung abgeschlossen hat, darf sie nicht NDIS_STATUS_SUCCESS zurückgeben.

Wenn die Erweiterung die OID-Set-Anforderung von OID_SWITCH_PORT_CREATE nicht erfüllt, wird die Anforderung durch den zugrunde liegenden Miniportrand des erweiterbaren Switches abgeschlossen. Der zugrunde liegende Miniportrand gibt den folgenden status Code für diese OID-Setanforderung zurück.