OID_SWITCH_PARAMETERS
Een Hyper-V uitbreidbare switchextensie geeft een OID-queryaanvraag (Object Identifier) van OID_SWITCH_PARAMETERS op om de configuratiegegevens van de uitbreidbare switch te verkrijgen.
Als de OID-queryaanvraag is voltooid, bevat de InformationBuffer lid van de NDIS_OID_REQUEST-structuur een aanwijzer naar een NDIS_SWITCH_PARAMETERS-structuur.
Opmerkingen
Wanneer de extensie de geretourneerde NDIS_SWITCH_PARAMETERS structuur verwerkt, mag niet worden aangenomen dat de verschillende tekenreeksleden van de NDIS_SWITCH_PARAMETERS-structuur, zoals SwitchName, null-beƫindigd zijn. De gegevenstypen voor deze tekenreeksleden worden door de IF_COUNTED_STRING structuur gedefinieerd. De extensie moet de tekenreekslengte bepalen op basis van de waarde van de Lengte lid van deze structuur.
Opmerking Als de tekenreeks null-beƫindigd is, mag het Lengte lid het afsluit-null-teken niet bevatten.
Statuscodes retourneren
De onderliggende minipoortrand van de uitbreidbare switch voltooit de OID-queryaanvraag van OID_SWITCH_PARAMETERS en retourneert een van de volgende statuscodes.
Statuscode | Beschrijving |
---|---|
NDIS_STATUS_SUCCESS |
De OID-aanvraag is voltooid. |
NDIS_STATUS_INVALID_LENGTH |
De lengte van de informatiebuffer is te klein om de OID_SWITCH_PARAMETERS structuur voor een OID-queryaanvraag te retourneren. De onderliggende minipoortrand van de uitbreidbare switch 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) |