OID_GEN_ISOLATION_PARAMETERS
NDIS- och överdrivna drivrutiner utfärdar en OID-begäran (object identifier) för OID_GEN_ISOLATION_PARAMETERS för att hämta parametrarna för konfiguration av flera innehavare (isolering) som anges på ett vm-nätverkskorts port.
Även om varje routningsdomän konfigureras separat på porten returnerar den här OID parametrarna för alla routningsdomäner i en enda fråga.
En överdrivande drivrutin bör utfärda denna OID i två steg:
- Io frågar den nödvändiga buffertstorleken, utfärdar OID-frågan med Size medlem i Header medlem i NDIS_ISOLATION_PARAMETERS-strukturen inställd på NDIS_SIZEOF_NDIS_ISOLATION_PARAMETERS_REVISION_1. (Se NDIS_STATUS_INVALID_LENGTH nedan.)
- Utfärda OID med en InformationBuffer- av den storlek som krävs.
Om OID-frågebegäran har slutförts innehåller InformationBuffer medlem i NDIS_OID_REQUEST-strukturen en pekare till en buffert. Den här bufferten innehåller följande data i ordning:
En NDIS_ISOLATION_PARAMETERS struktur
En eller flera NDIS_ROUTING_DOMAIN_ENTRY strukturer, en för varje routningsdomän
En eller flera NDIS_ROUTING_DOMAIN_ISOLATION_ENTRY strukturer, grupperade efter routningsdomän
I varje NDIS_ROUTING_DOMAIN_ENTRY struktur innehåller FirstIsolationInfoEntryOffset medlem förskjutningen från början av OID-informationsbufferten (dvs. början av bufferten som InformationBuffer medlem i NDIS_OID_REQUEST struktur pekar på) till den första NDIS_ROUTING_DOMAIN_ISOLATION_ENTRY för routningsdomänen. Förskjutningen i NextIsolationInfoEntryOffset medlem i den sista strukturen i listan är noll.
Om inga konfigurationsparametrar för flera innehavare har angetts på den virtuella datorns nätverkskort anger miniportdrivrutinen för nätverkskortet DATA. QUERY_INFORMATION. BytesWritten medlem i NDIS_OID_REQUEST struktur till noll och returnerar NDIS_STATUS_SUCCESS. I det här fallet data i DATA. QUERY_INFORMATION. InformationBuffer medlem ändras inte av miniportdrivrutinen.
Anmärkningar
Returstatuskoder
Miniportdrivrutinen för den virtuella datorns nätverkskort returnerar någon av följande statuskoder för den här OID-begäran:
| 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 den begärda informationen. Miniportdrivrutinen för den virtuella datorns nätverkskort anger DATA. METHOD_INFORMATION. BytesNeededed medlem i NDIS_OID_REQUEST struktur till den minsta buffertstorlek, i byte, som krävs. |
NDIS_STATUS_FAILURE |
Begäran misslyckades av andra skäl. |
Krav
Version |
Stöds i NDIS 6.40 och senare. |
Rubrik |
Ntddndis.h (inkludera Ndis.h) |