OID_SWITCH_PROPERTY_ENUM
Den Hyper-V utökningsbara växeltillägget utfärdar en OID-metodbegäran (object identifier) för OID_SWITCH_PROPERTY_ENUM för att hämta en matris. Den här matrisen innehåller de etablerade växelprinciper som matchar de angivna kriterierna. Varje element i matrisen anger egenskaperna för en utökningsbar växelprincip.
InformationBuffer medlem i NDIS_OID_REQUEST-strukturen innehåller en pekare till en buffert. Den här bufferten innehåller följande data:
En NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS struktur som anger parametrarna för uppräkning av utökningsbara växelprinciper.
En matris med NDIS_SWITCH_PROPERTY_ENUM_INFO strukturer. Var och en av dessa strukturer innehåller information om en utökningsbar växelprincip.
Obs Om tillägget inte har etablerats med instanser av den angivna utökningsbara växelprincipen anger tillägget NumProperties medlem i NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS struktur till noll och inga NDIS_SWITCH_PROPERTY_ENUM_INFO strukturer returneras.
Anmärkningar
OID_SWITCH_PROPERTY_ENUM OID får endast utfärdas när Hyper-V utökningsbara växeln har slutfört aktiveringen. Mer information finns i Fråga Hyper-V Utökningsbar växelkonfiguration.
Till skillnad från OID-frågebegäranden från OID_SWITCH_PORT_PROPERTY_ENUMbehöver tillägget inte anropa några ReferenceSwitchXxx- eller DereferenceSwitchXxx funktioner när det utfärdar OID_SWITCH_PROPERTY_ENUM begäran ned den utökningsbara växeldrivrutinsstacken.
Obs Om tillägget tar emot OID-metodens begäran om OID_SWITCH_PROPERTY_ENUM får den inte slutföra OID-begäran. I stället måste den anropa NdisFOidRequest- för att vidarebefordra OID-begäran ned den utökningsbara växeldrivrutinsstacken.
Returstatuskoder
Den underliggande miniportgränsen för den utökningsbara växeln slutför OID-frågebegäran för OID_SWITCH_PROPERTY_ENUM och returnerar någon av följande statuskoder.
| Statuskod | Beskrivning |
|---|---|
NDIS_STATUS_SUCCESS |
OID-begäran har slutförts. |
NDIS_STATUS_INVALID_LENGTH |
Informationsbuffertens längd är för liten för att returnera NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS struktur och dess matris med NDIS_SWITCH_PROPERTY_ENUM_INFO element. Den utökningsbara växelns underliggande miniportgräns anger DATA. METHOD_INFORMATION. BytesNeeded medlem i NDIS_OID_REQUEST struktur till den minsta buffertstorlek som krävs. |
NDIS_STATUS_FAILURE |
Begäran misslyckades av andra skäl. |
Krav
Version |
Stöds i NDIS 6.30 och senare. |
Rubrik |
Ntddndis.h (inkludera Ndis.h) |
Se även
NDIS_SWITCH_PROPERTY_ENUM_INFO