Dela via


OID_NIC_SWITCH_VPORT_PARAMETERS

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:

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:

  1. Den VPortId- medlemmen är inställd på identifieraren för den VPort vars parametrar kommer att ändras.

  2. 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.

  3. 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.

Krav

Version

Stöds i NDIS 6.30 och senare.

Rubrik

Ntddndis.h (inkludera Ndis.h)

Se även


NDIS_NIC_SWITCH_VPORT_PARAMETERS

NDIS_OID_REQUEST

OID_NIC_SWITCH_CREATE_VPORT

OID_NIC_SWITCH_ENUM_VPORTS