OID_SWITCH_PORT_CREATE

Artikel
03/13/2025

Protokollgränsen för den Hyper-V utökningsbara växeln utfärdar en begäran om objektidentifierare (OID) för OID_SWITCH_PORT_CREATE för att meddela utökningsbara växeltillägg om skapandet av en utökningsbar växelport.

InformationBuffer medlem i NDIS_OID_REQUEST-strukturen innehåller en pekare till en NDIS_SWITCH_PORT_PARAMETERS struktur.

Anmärkningar

PortId medlem i NDIS_SWITCH_PORT_PARAMETERS-strukturen anger porten som meddelandet om att skapa görs för.

Det utökningsbara switchtillägget måste följa dessa riktlinjer för hantering av OID-uppsättningsbegäranden för OID_SWITCH_PORT_CREATE:

Tillägget får inte ändra den NDIS_SWITCH_PORT_PARAMETERS struktur som är associerad med OID-begäran.
Tillägget kan lägga in sitt veto mot meddelandet om att skapa genom att returnera NDIS_STATUS_DATA_NOT_ACCEPTED för OID-begäran. Om ett tillägg till exempel inte kan allokera resurser för att framtvinga dess konfigurerade principer på porten bör drivrutinen lägga in sitt veto mot meddelandet om att skapa.

Om tillägget returnerar andra NDIS_STATUS_Xxx felstatuskoder läggs även meddelandet om att skapa in sitt veto. Att returnera statuskoder för övergående scenarier, till exempel att returnera NDIS_STATUS_RESOURCES, kan dock resultera i ett nytt försök att skapa meddelandet.

Om tillägget inte lägger in sitt veto mot OID-begäran bör det övervaka statusen när begäran har slutförts. Tillägget bör göra detta för att avgöra om OID-begäran lades in med veto av underliggande tillägg i den utökningsbara växelkontrollsökvägen eller av det utökningsbara växelgränssnittet.

Mer information om portprinciper finns i Hantera Hyper-V Utökningsbara switchprinciper.
Om tillägget anropar NdisFOidRequest för att vidarebefordra denna OID-uppsättningsbegäran bör tillägget övervaka slutförandestatusen för den här OID-begäran. Tillägget gör detta för att identifiera om underliggande tillägg i den utökningsbara växeldrivrutinsstacken har veto mot meddelandet om att porten har skapats.
När OID-begäran har vidarebefordrats och slutförts kan tillägget utfärda OID-begäranden för porten, till exempel OID_SWITCH_PORT_PROPERTY_ENUM, tills en OID-begäran om OID_SWITCH_PORT_TEARDOWN har utfärdats. Den här OID-begäran meddelar tillägget att porten påbörjar borttagningsprocessen från den utökningsbara växeln.
Tillägg kan inte vidarebefordra paket till den angivna porten i NDIS_SWITCH_PORT_PARAMETERS-strukturen förrän en OID-uppsättningsbegäran om OID_SWITCH_NIC_CONNECT har utfärdats och har slutförts.

Note Extensions får inte utfärda OID-uppsättningsbegäranden för OID_SWITCH_PORT_CREATE.

Mer information om tillstånd för utökningsbara växelportar och nätverkskortanslutningar finns i Hyper-V Extensible Switch Port and Network Adapter States.

Returstatuskoder

Om tillägget slutför OID-uppsättningens begäran om OID_SWITCH_PORT_CREATE returneras någon av följande statuskoder.

Statuskod	Beskrivning
NDIS_STATUS_DATA_NOT_ACCEPTED	Tillägget lade in sitt veto mot meddelandet om att skapa.
NDIS_STATUS_RESOURCES	Tillägget lade in sitt veto mot meddelandet om att skapa på grund av ett låg resursvillkor.
NDIS_STATUS_Xxx	Tillägget lade in sitt veto mot att skapa anmälan av andra skäl.

Obs Om tillägget slutför begäran om OID-uppsättning får det inte returnera NDIS_STATUS_SUCCESS.

Om tillägget inte slutför OID-uppsättningens begäran om OID_SWITCH_PORT_CREATE slutförs begäran av den underliggande miniportkanten för den utökningsbara växeln. Den underliggande miniport-gränsen returnerar följande statuskod för denna OID-uppsättningsbegäran.