OID_NIC_SWITCH_HARDWARE_CAPABILITIES
En överdrivande drivrutin utfärdar en OID-frågebegäran (object identifier) för OID_NIC_SWITCH_HARDWARE_CAPABILITIES för att hämta maskinvarufunktionerna för nätverkskortsväxeln i nätverkskortet.
Efter en lyckad retur från OID-frågebegäran innehåller InformationBuffer medlem i NDIS_OID_REQUEST-strukturen en pekare till en NDIS_NIC_SWITCH_CAPABILITIES struktur.
Anmärkningar
Den NDIS_NIC_SWITCH_CAPABILITIES strukturen innehåller information om maskinvarufunktionerna för en nätverkskortsväxel på nätverkskortet. Dessa funktioner kan omfatta maskinvarufunktioner som för närvarande är inaktiverade av INF-filinställningarna eller via sidan Avancerade egenskaper.
Obs Alla funktioner i den angivna nätverkskortsväxeln returneras via en OID-frågebegäran av OID_NIC_SWITCH_HARDWARE_CAPABILITIES, oavsett om en funktion är aktiverad eller inaktiverad.
Från och med NDIS 6.20 tillhandahåller miniportdrivrutiner maskinvarufunktionerna för nätverkskortsväxlar när dess MiniportInitializeEx-funktion anropas. Drivrutinen initierar en NDIS_NIC_SWITCH_CAPABILITIES struktur med maskinvarufunktionerna för nätverkskortsväxling och anger HardwareNicSwitchCapabilities medlem i NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES struktur till en pekare till NDIS_NIC_SWITCH_CAPABILITIES struktur. Miniportdrivrutinen anropar sedan funktionen NdisMSetMiniportAttributes och anger parametern MiniportAttributes till en pekare till en NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES struktur.
Obs Från och med NDIS 6.30 måste miniportdrivrutiner som stöder det enda rot-I/O-virtualiseringsgränssnittet (SR-IOV) registrera maskinvarufunktionerna för nätverkskortets växel. Drivrutiner registrerar dessa funktioner genom att anropa NdisMSetMiniportAttributes.
Returstatuskoder
NDIS hanterar OID-frågebegäran för OID_NIC_SWITCH_HARDWARE_CAPABILITIES begäran för miniportdrivrutiner och returnerar någon av följande statuskoder:
| Statuskod | Beskrivning |
|---|---|
NDIS_STATUS_SUCCESS |
Begäran har slutförts. InformationBuffer- pekar på en NDIS_NIC_SWITCH_CAPABILITIES struktur. |
NDIS_STATUS_NOT_SUPPORTED |
Miniportdrivrutinen stöder antingen inte det enda rot-I/O-virtualiseringsgränssnittet (SR-IOV) eller så är den inte aktiverad för att använda gränssnittet. |
NDIS_STATUS_INVALID_LENGTH |
Längden på informationsbufferten är mindre än sizeof(NDIS_NIC_SWITCH_CAPABILITIES). NDIS anger DATA. QUERY_INFORMATION. BytesNeeded medlem 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.20 och senare. |
Rubrik |
Ntddndis.h (inkludera Ndis.h) |