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:

Requirements

See also

NDIS_ISOLATION_PARAMETERS

NDIS_OID_REQUEST

NDIS_ROUTING_DOMAIN_ENTRY

NDIS_ROUTING_DOMAIN_ISOLATION_ENTRY

NDIS_STATUS_ISOLATION_PARAMETERS_CHANGE