OID_NIC_SWITCH_ENUM_SWITCHES
Een te groot stuurprogramma of toepassing in de gebruikersmodus geeft een OID-queryaanvraag (Object Identifier) van OID_NIC_SWITCH_ENUM_SWITCHES om een matrix te verkrijgen. Elk element in de matrix specificeert de kenmerken van een NIC-switch die is gemaakt op een netwerkadapter.
Nadat deze OID-queryaanvraag is geretourneerd, bevat de InformationBuffer lid van de NDIS_OID_REQUEST-structuur een aanwijzer naar een buffer die het volgende bevat:
Een NDIS_NIC_SWITCH_INFO_ARRAY structuur waarmee het aantal elementen in de matrix wordt gedefinieerd.
Een matrix van NDIS_NIC_SWITCH_INFO structuren. Elk van deze structuren bevat de informatie over één NIC-switch die op de netwerkadapter is gemaakt.
Opmerking Als de netwerkadapter geen NIC-switches heeft, stelt het stuurprogramma de NumElements lid van de NDIS_NIC_SWITCH_INFO_ARRAY structuur in op nul en worden er geen NDIS_NIC_SWITCH_INFO structuren geretourneerd.
Opmerkingen
Het overliggen van stuurprogramma's en toepassingen in de gebruikersmodus geven OID-queryaanvragen van OID_NIC_SWITCH_ENUM_SWITCHES om de NIC-switches op te sommen die zijn gemaakt op een netwerkadapter.
Opmerking Vanaf Windows Server 2012 ondersteunt de I/O-interface met één hoofdmap (SR-IOV) alleen de standaard-NIC-switch op de netwerkadapter. Daarom moet de geretourneerde NDIS_NIC_SWITCH_INFO_ARRAY structuur één NDIS_NIC_SWITCH_INFO-element opgeven voor de standaard-NIC-switch, waarnaar wordt verwezen door de id van NDIS_DEFAULT_SWITCH_ID.
Statuscodes retourneren
NDIS verwerkt de OID-queryaanvraag van de OID_NIC_SWITCH_ENUM_SWITCHES aanvraag voor minipoortstuurprogramma's. De chauffeurs worden deze OID-aanvraag niet uitgegeven.
Wanneer NDIS de OID_NIC_SWITCH_ENUM_SWITCHES aanvraag verwerkt, wordt een van de volgende statuscodes geretourneerd.
Statuscode | Beschrijving |
---|---|
NDIS_STATUS_SUCCESS |
De OID-aanvraag is voltooid. |
NDIS_STATUS_NOT_SUPPORTED |
Het minipoortstuurprogramma biedt geen ondersteuning voor de SR-IOV interface of is niet ingeschakeld voor het gebruik van de interface. |
NDIS_STATUS_INVALID_PARAMETER |
Een of meer leden van de NDIS_NIC_SWITCH_INFO_ARRAY structuur hebben ongeldige waarden. |
NDIS_STATUS_INVALID_LENGTH |
De informatiebuffer was te kort. 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.30 en hoger. |
Rubriek |
Ntddndis.h (inclusief Ndis.h) |