Delen via


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)

Zie ook


NDIS_OID_REQUEST

NDIS_SWITCH_PARAMETERS

NdisFOidRequest