OID_SWITCH_NIC_CONNECT

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_NIC_CONNECT för att meddela underliggande utökningsbara växeltillägg att en nätverksanslutning mellan en utökningsbar växelport och ett nätverkskort är helt upprättad. Protokollgränsen har tidigare meddelat tillägg om att den här anslutningen upprättas när den utfärdade en OID-uppsättningsbegäran av OID_SWITCH_NIC_CREATE.

InformationBuffer medlem i NDIS_OID_REQUEST struktur innehåller en pekare till en NDIS_SWITCH_NIC_PARAMETERS struktur.

Anmärkningar

PortId medlem i NDIS_SWITCH_NIC_PARAMETERS-strukturen anger den utökningsbara växelport som anslutningsmeddelandet görs för. Det utökningsbara växeltillägget kan hämta parameterinformationen för den här porten och andra utökningsbara växelportar på följande sätt:

Genom att utfärda OID-frågebegäranden för OID_SWITCH_PORT_ARRAY. Tillägget utfärdar denna OID på FilterAttach endast när OID_SWITCH_PARAMETERS returnerar en NDIS_SWITCH_PARAMETERS struktur med IsActive inställd på TRUE. Om IsActive är FALSE utfärdar tillägget OID när NetEventSwitchActivateNET_PNP_EVENT utfärdas av tilläggets miniportkort.
Genom att granska de olika OID-uppsättningarna begärs OID_SWITCH_PORT_CREATE och OID_SWITCH_PORT_DELETE.

Index medlem i NDIS_SWITCH_NIC_PARAMETERS-strukturen anger indexet för ett nätverkskort som anslutningsmeddelandet görs för. Nätverkskortet med det angivna Index-värdet är anslutet till den utökningsbara växelport som anges av PortId-medlemmen. Mer information om dessa indexvärden finns i Indexvärden för nätverkskort.

När den tar emot OID-uppsättningens begäran om OID_SWITCH_NIC_CONNECT måste tillägget följa dessa riktlinjer:

När OID_SWITCH_NIC_CONNECT begäran slutförs med NDIS_STATUS_SUCCESS är nätverksanslutningen och utökningsbara växelporten helt i drift. Tillägget kan generera eller vidarebefordra pakettrafik till portens nätverksanslutning. Tillägget kan också utfärda utökningsbara switch-OID:er eller statusindikationer som använder porten som källport. Tillägget kan också anropa ReferenceSwitchPort för att öka den utökningsbara växelreferensräknaren för porten.
Tillägget får inte ändra den NDIS_SWITCH_NIC_PARAMETERS struktur som är associerad med OID-begäran.
Tillägget måste alltid anropa NdisFOidRequest för att vidarebefordra denna OID-begäran till underliggande tillägg. Tillägget får inte slutföra själva OID-begäran.
Det utökningsbara växelns externa nätverkskort kan binda till ett eller flera underliggande fysiska kort. För varje fysiskt nätverkskort som är bundet till det externa nätverkskortet utfärdar protokollgränsen för den utökningsbara växeln en separat OID-uppsättningsbegäran om OID_SWITCH_NIC_CONNECT. Varje OID-uppsättningsbegäran anger ett annat indexvärde för nätverkskortanslutning. Mer information om dessa värden finns i Indexvärden för nätverkskort.

Tillägget måste behålla anslutningstillståndet för varje underliggande fysiskt kort som är bundet till det externa nätverkskortet. Mer information om de olika konfigurationer där fysiska nätverkskort kan bindas till det externa nätverkskortet finns i typer av konfigurationer av fysiska nätverkskort.

Obs Tillägget får inte utfärda sina egna OID-uppsättningsbegäranden för OID_SWITCH_NIC_CONNECT.

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

Den underliggande miniportgränsen för den utökningsbara växeln slutför OID-uppsättningens begäran om OID_SWITCH_NIC_CONNECT och returnerar följande statuskod.