OID_GEN_ISOLATION_PARAMETERS

NDIS and overlying drivers issue an object identifier (OID) request of OID_GEN_ISOLATION_PARAMETERS to obtain the multi-tenancy configuration (isolation) parameters that are set on a VM network adapter's port.

Although each routing domain is configured separately on the port, this OID returns parameters for all of the routing domains in a single query.

An overlying driver should issue this OID in two steps:

  1. Io query the required buffer size, issue the OID query with the Size member of the Header member of the NDIS_ISOLATION_PARAMETERS structure set to NDIS_SIZEOF_NDIS_ISOLATION_PARAMETERS_REVISION_1. (See NDIS_STATUS_INVALID_LENGTH below.)
  2. Issue the OID with an InformationBuffer of the required size.

If the OID query request is completed successfully, the InformationBuffer member of the NDIS_OID_REQUEST structure contains a pointer to a buffer. This buffer contains the following data, in order:

  1. An NDIS_ISOLATION_PARAMETERS structure

  2. One or more NDIS_ROUTING_DOMAIN_ENTRY structures, one for each routing domain

  3. One or more NDIS_ROUTING_DOMAIN_ISOLATION_ENTRY structures, grouped by routing domain

In each NDIS_ROUTING_DOMAIN_ENTRY structure, the FirstIsolationInfoEntryOffset member contains the offset from the beginning of the OID information buffer (that is, the beginning of the buffer that the InformationBuffer member of the NDIS_OID_REQUEST structure points to) to the first NDIS_ROUTING_DOMAIN_ISOLATION_ENTRY for that routing domain. The offset in the NextIsolationInfoEntryOffset member of the last structure in the list is zero.

If no multi-tenancy configuration parameters are set on the VM network adapter, the network adapter miniport driver sets the DATA.QUERY_INFORMATION.BytesWritten member of the NDIS_OID_REQUEST structure to zero and returns NDIS_STATUS_SUCCESS. In this case, the data within the DATA.QUERY_INFORMATION.InformationBuffer member is not modified by the miniport driver.

Remarks

Return Status Codes

The VM network adapter miniport driver returns one of the following status codes for this OID request:

Status CodeDescription

NDIS_STATUS_SUCCESS

The OID request completed successfully.

NDIS_STATUS_INVALID_LENGTH

The length of the information buffer is too small to return the requested information. The VM network adapter miniport driver sets the DATA.METHOD_INFORMATION.BytesNeeded member in the NDIS_OID_REQUEST structure to the minimum buffer size, in bytes, that is required.

NDIS_STATUS_FAILURE

The request failed for other reasons.

 

Requirements

Version

Supported in NDIS 6.40 and later.

Header

Ntddndis.h (include Ndis.h)

See also

NDIS_ISOLATION_PARAMETERS
NDIS_OID_REQUEST
NDIS_ROUTING_DOMAIN_ENTRY
NDIS_ROUTING_DOMAIN_ISOLATION_ENTRY
NDIS_STATUS_ISOLATION_PARAMETERS_CHANGE

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft