Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
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:
- 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.)
- 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:
An NDIS_ISOLATION_PARAMETERS structure
One or more NDIS_ROUTING_DOMAIN_ENTRY structures, one for each routing domain
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 Code | Description |
|---|---|
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) |