OID_NIC_SWITCH_HARDWARE_CAPABILITIES
Een overliggend stuurprogramma geeft een OID-queryaanvraag (Object Identifier) van OID_NIC_SWITCH_HARDWARE_CAPABILITIES om de hardwaremogelijkheden van de NIC-switch in de netwerkadapter te verkrijgen.
Nadat de OID-queryaanvraag is geretourneerd, bevat de InformationBuffer lid van de NDIS_OID_REQUEST-structuur een aanwijzer naar een NDIS_NIC_SWITCH_CAPABILITIES-structuur.
Opmerkingen
De NDIS_NIC_SWITCH_CAPABILITIES structuur bevat informatie over de hardwaremogelijkheden van een NIC-switch op de netwerkadapter. Deze mogelijkheden kunnen de hardwaremogelijkheden omvatten die momenteel zijn uitgeschakeld door de INSTELLINGEN van het INF-bestand of via de pagina Geavanceerde eigenschappen.
Opmerking Alle mogelijkheden van de opgegeven NIC-switch worden geretourneerd via een OID-queryaanvraag van OID_NIC_SWITCH_HARDWARE_CAPABILITIES, ongeacht of een mogelijkheid is ingeschakeld of uitgeschakeld.
Vanaf NDIS 6.20 leveren minipoortstuurprogramma's de hardwaremogelijkheden van de NIC-switch wanneer de functie MiniportInitializeEx wordt aangeroepen. Het stuurprogramma initialiseert een NDIS_NIC_SWITCH_CAPABILITIES structuur met de hardwaremogelijkheden van de NIC-switch en stelt de HardwareNicSwitchCapabilities lid van de NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES structuur in op een aanwijzer naar de NDIS_NIC_SWITCH_CAPABILITIES structuur. Het minipoortstuurprogramma roept vervolgens de NdisMSetMiniportAttributes functie aan en stelt de parameter MiniportAttributes in op een aanwijzer naar een NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES structuur.
Opmerking Vanaf NDIS 6.30 moeten minipoortstuurprogramma's die ondersteuning bieden voor de I/O-interface met één hoofdmap (SR-IOV) de hardwaremogelijkheden van de NIC-switch registreren. Stuurprogramma's registreren deze mogelijkheden door NdisMSetMiniportAttributesaan te roepen.
Statuscodes retourneren
NDIS verwerkt de OID-queryaanvraag van OID_NIC_SWITCH_HARDWARE_CAPABILITIES aanvraag voor minipoortstuurprogramma's en retourneert een van de volgende statuscodes:
| Statuscode | Beschrijving |
|---|---|
NDIS_STATUS_SUCCESS |
De aanvraag is voltooid. De InformationBuffer- verwijst naar een NDIS_NIC_SWITCH_CAPABILITIES structuur. |
NDIS_STATUS_NOT_SUPPORTED |
Het minipoortstuurprogramma biedt geen ondersteuning voor de I/O-interface met één hoofdmap (SR-IOV) of is niet ingeschakeld voor het gebruik van de interface. |
NDIS_STATUS_INVALID_LENGTH |
De lengte van de informatiebuffer is kleiner dan grootte (NDIS_NIC_SWITCH_CAPABILITIES). NDIS stelt de DATA in. QUERY_INFORMATION. BytesNeeded lid in de NDIS_OID_REQUEST structuur tot de minimale buffergrootte die is vereist. |
NDIS_STATUS_FAILURE |
De aanvraag is om andere redenen mislukt. |
Eisen
Versie |
Ondersteund in NDIS 6.20 en hoger. |
Rubriek |
Ntddndis.h (inclusief Ndis.h) |