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:
- 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) |