OID_NIC_SWITCH_PARAMETERS
En överdrivande drivrutin utfärdar en OID-metodbegäran (object identifier) för OID_NIC_SWITCH_PARAMETERS för att hämta de aktuella konfigurationsparametrarna för en angiven nätverkskortsväxel på ett nätverkskort. NDIS hanterar dessa OID-metodbegäranden för miniportdrivrutinen.
Överdrivande drivrutiner utfärdar en OID-uppsättningsbegäran av OID_NIC_SWITCH_PARAMETERS för att ange konfigurationsparametrarna för en angiven nätverkskortsväxel på ett nätverkskort. 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-strukturen innehåller en pekare till en NDIS_NIC_SWITCH_PARAMETERS struktur.
Den överdrivande drivrutinen anger NIC-växeln för OID-metoden eller anger begäran genom att ange SwitchId medlem i NDIS_NIC_SWITCH_PARAMETERS struktur till växelidentifieraren. Den överdrivande drivrutinen hämtar växelidentifieraren på något av följande sätt:
Från en tidigare OID-metodbegäran för OID_NIC_SWITCH_ENUM_SWITCHES.
Från NicSwitchArray medlem i NDIS_BIND_PARAMETERS struktur. NDIS skickar en pekare till den här strukturen i parametern BindParameters för funktionen ProtocolBindAdapterEx.
Från NicSwitchArray medlem i den NDIS_FILTER_ATTACH_PARAMETERS strukturen. NDIS skickar en pekare till den här strukturen i parametern AttachParameters för funktionen FilterAttach.
Obs Från och med Windows Server 2012 stöder Windows endast standard-NIC-växeln på nätverkskortet. SwitchId medlem i NDIS_NIC_SWITCH_PARAMETERS-strukturen måste anges till NDIS_DEFAULT_SWITCH_ID.
Anmärkningar
Den överdrivande drivrutinen utfärdar OID_NIC_SWITCH_PARAMETERS begäranden på följande sätt:
Den överdrivande drivrutinen utfärdar en OID-metodbegäran av OID_NIC_SWITCH_PARAMETERS för att hämta de aktuella parametrarna för en angiven NIC-växel. Mer information finns i Köra frågor mot parametrarna för en nätverkskortsväxel.
Note NDIS hanterar OID-metodbegäranden för OID_NIC_SWITCH_PARAMETERS för PF-miniportdrivrutinen.
Den överdrivande drivrutinen utfärdar en OID-uppsättningsbegäran av OID_NIC_SWITCH_PARAMETERS för att ändra de aktuella parametrarna för en angiven NIC-växel. Mer information finns i Ange parametrar för en nätverkskortsväxel.
Obs PF-miniportdrivrutinen hanterar OID-uppsättningsbegäranden för OID_NIC_SWITCH_PARAMETERS.
Returstatuskoder
NDIS eller PF-miniportdrivrutinen returnerar följande statuskoder för OID-begäranden för OID_NIC_SWITCH_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_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_REINIT_REQUIRED |
PF-miniportdrivrutinen kräver en ominitiering av nätverkskortet för att tillämpa ändringarna på nätverkskortsväxeln. |
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) |