OID_NIC_SWITCH_VPORT_PARAMETERS

Artikel
03/13/2025

En överliggande drivrutin kan hämta parametrarna för en virtuell port (VPort) på en nätverkskortsväxel som har skapats på ett nätverkskort som stöder enkel rot-I/O-virtualisering (SR-IOV). Drivrutinen utfärdar en OID-metodbegäran (object identifier) för OID_NIC_SWITCH_VPORT_PARAMETERS för att hämta dessa parametrar.

Överdrivande drivrutiner utfärdar en OID-uppsättningsbegäran om OID_NIC_SWITCH_VPORT_PARAMETERS för att ange konfigurationsparametrarna för en angiven VPort som är ansluten till nätverkskortets nätverkskortsväxel. Dessa OID-uppsättningsbegäranden utfärdas till miniportdrivrutinen för nätverkskortets FYSISKA PCI Express-funktion (PCIe). Dessa OID-uppsättningsbegäranden krävs för PF-miniportdrivrutiner som stöder gränssnittet för enkel rot-I/O-virtualisering (SR-IOV).

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

Den överliggande drivrutinen anger VPort för OID-metoden eller anger begäran genom att ange VPortId medlem i NDIS_NIC_SWITCH_VPORT_PARAMETERS-strukturen till identifieraren som är associerad med VPort. Den överdrivande drivrutinen hämtar VPort-identifieraren på något av följande sätt:

Från en tidigare OID-metodbegäran för OID_NIC_SWITCH_CREATE_VPORT.
Från en tidigare OID-metodbegäran för OID_NIC_SWITCH_ENUM_VPORTS.

Anmärkningar

OID_NIC_SWITCH_VPORT_PARAMETERS kan användas i antingen OID-metodbegäranden eller OID-uppsättningsbegäranden.

hantera OID-metodbegäranden för OID_NIC_SWITCH_VPORT_PARAMETERS

Överförbrukningsdrivrutiner utfärdar en OID-metodbegäran av OID_NIC_SWITCH_VPORT_PARAMETERS för att fråga de aktuella konfigurationsparametrarna för en VPort som är kopplad till nätverkskortets nätverkskortsväxel. Överdrivande drivrutiner anger den VPort som ska frågas genom att ange VPortId medlem i NDIS_NIC_SWITCH_VPORT_PARAMETERS-strukturen till VPort-identifieraren.

NDIS hanterar OID-metodens begäran om OID_NIC_SWITCH_VPORT_PARAMETERS för miniportdrivrutiner. NDIS returnerar information som den fått från tidigare OID-begäranden av OID_NIC_SWITCH_CREATE_VPORT och OID_NIC_SWITCH_ENUM_VPORTS.

Efter en lyckad retur från OID-metodbegäran innehåller InformationBuffer medlem i NDIS_OID_REQUEST-strukturen en pekare till en NDIS_NIC_SWITCH_VPORT_PARAMETERS struktur. Den här strukturen innehåller konfigurationsparametrarna för den angivna växeln.

Mer information finns i Köra frågor mot parametrarna för en virtuell port.

hantering av OID-uppsättningsbegäranden för OID_NIC_SWITCH_VPORT_PARAMETERS

Överförbrukningsdrivrutiner utfärdar en OID-uppsättningsbegäran om OID_NIC_SWITCH_VPORT_PARAMETERS för att ändra de aktuella konfigurationsparametrarna för en VPort som är ansluten till nätverkskortets nätverkskortsväxel. Den här OID-begäran kan användas för att uppdatera parametrarna för standard och nondefault VPorts.

Endast en begränsad delmängd av konfigurationsparametrarna för en VPort kan ändras. Den överdrivande drivrutinen anger vilken parameter som ska ändras genom att ange följande medlemmar i den NDIS_NIC_SWITCH_VPORT_PARAMETERS strukturen:

Den VPortId- medlemmen är inställd på identifieraren för den VPort vars parametrar kommer att ändras.
Lämpliga NDIS_NIC_SWITCH_VPORT_PARAMETERS_Xxx_CHANGED flaggor anges i Flags-medlemmen. Medlemmar i NDIS_NIC_SWITCH_VPORT_PARAMETERS-strukturen kan bara ändras om en motsvarande NDIS_NIC_SWITCH_PARAMETERS_Xxx_CHANGED-flagga definieras i Ntddndis.h.
Motsvarande medlemmar i NDIS_NIC_SWITCH_VPORT_PARAMETERS struktur anges med de VPort-konfigurationsparametrar som ska ändras.

När PF-miniportdrivrutinen har fått OID-uppsättningens begäran om OID_NIC_SWITCH_VPORT_PARAMETERS konfigurerar drivrutinen maskinvaran med konfigurationsparametrarna. Drivrutinen kan bara ändra de konfigurationsparametrar som identifieras av NDIS_NIC_SWITCH_VPORT_PARAMETERS_Xxx_CHANGED flaggor i Flags medlem i NDIS_NIC_SWITCH_VPORT_PARAMETERS-strukturen.

Mer information finns i Ange parametrar för en virtuell port.

Returstatuskoder

NDIS eller PF-miniportdrivrutinen returnerar följande statuskod för OID-begäranden för uppsättning eller metod för OID_NIC_SWITCH_VPORT_PARAMETERS.

Statuskod	Beskrivning
NDIS_STATUS_SUCCESS	Begäran har slutförts. InformationBuffer- pekar på en NDIS_NIC_SWITCH_CAPABILITIES struktur.
NDIS_STATUS_NOT_SUPPORTED	PF-miniportdrivrutinen stöder antingen inte det enskilda rot-I/O-virtualiseringsgränssnittet (SR-IOV) eller så är den inte aktiverad för att använda gränssnittet.
NDIS_STATUS_INVALID_PARAMETER	En eller flera av medlemmarna i NDIS_NIC_SWITCH_VPORT_PARAMETERS struktur har ogiltiga värden.
NDIS_STATUS_INVALID_LENGTH	Informationsbufferten var för kort. NDIS eller PF-miniportdrivrutinen anger DATA. METHOD_INFORMATION. BytesNeededed medlem (för OID-metodbegäranden) eller DATA. SET_INFORMATION. BytesNeededed medlem (för OID-uppsättningsbegäranden) i NDIS_OID_REQUEST struktur till den minsta buffertstorlek som krävs.
NDIS_STATUS_FAILURE	Begäran misslyckades av andra skäl.