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:

  1. 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.)
  2. 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:

  1. En NDIS_ISOLATION_PARAMETERS struktur

  2. En eller flera NDIS_ROUTING_DOMAIN_ENTRY strukturer, en för varje routningsdomän

  3. 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)

Se även

NDIS_ISOLATION_PARAMETERS

NDIS_OID_REQUEST

NDIS_ROUTING_DOMAIN_ENTRY

NDIS_ROUTING_DOMAIN_ISOLATION_ENTRY

NDIS_STATUS_ISOLATION_PARAMETERS_CHANGE

  • Last updated on