Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
Een overliggend stuurprogramma geeft een OID-queryaanvraag (Object Identifier) van OID_NIC_SWITCH_CURRENT_CAPABILITIES om de momenteel ingeschakelde hardwaremogelijkheden van de NIC-switch in een 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
Vanaf NDIS 6.20 leveren minipoortstuurprogramma's de momenteel ingeschakelde hardwaremogelijkheden van de NIC-switch op de netwerkadapter wanneer de MiniportInitializeEx functie wordt aangeroepen. Het stuurprogramma initialiseert een NDIS_NIC_SWITCH_CAPABILITIES structuur met de hardwaremogelijkheden van de NIC-switch en stelt de CurrentNicSwitchCapabilities 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 ingeschakelde hardwaremogelijkheden van de NIC-switch registreren. Stuurprogramma's registreren deze mogelijkheden door NdisMSetMiniportAttributesaan te roepen.
Overliggende protocol- en filterstuurprogramma's hoeven geen OID-queryaanvragen van OID_NIC_SWITCH_CURRENT_CAPABILITIES uit te geven. NDIS biedt de momenteel ingeschakelde hardwaremogelijkheden van een NIC-switch van een netwerkadapter naar deze stuurprogramma's op de volgende manier:
NDIS rapporteert de momenteel ingeschakelde hardwaremogelijkheden van een NIC-switch van een onderliggende netwerkadapter aan overliggende protocolstuurprogramma's in de NicSwitchCapabilities lid van de NDIS_BIND_PARAMETERS structuur tijdens de bindingsbewerking.
NDIS rapporteert de momenteel ingeschakelde hardwaremogelijkheden voor NIC-switch van een onderliggende netwerkadapter aan overliggende filterstuurprogramma's in de NicSwitchCapabilities lid van de NDIS_FILTER_ATTACH_PARAMETERS-structuur tijdens de koppelingsbewerking.
Statuscodes retourneren
NDIS verwerkt de OID-queryaanvraag van de OID_NIC_SWITCH_CURRENT_CAPABILITIES aanvraag voor minipoortstuurprogramma's. De chauffeurs worden deze OID-aanvraag niet uitgegeven.
Wanneer NDIS de OID_NIC_SWITCH_CURRENT_CAPABILITIES aanvraag verwerkt, wordt een van de volgende statuscodes geretourneerd:
| 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). Het minipoortstuurprogramma moet de DATA instellen. 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) |