通过

OID_GEN_ISOLATION_PARAMETERS

  • 项目

NDIS 和上层驱动程序发出对象标识符 (OID) OID_GEN_ISOLATION_PARAMETERS 请求，以获取在 VM 网络适配器的端口上设置的多租户配置 (隔离) 参数。

尽管每个路由域在端口上单独配置，但此 OID 在单个查询中返回所有路由域的参数。

过度覆盖的驱动程序应分两个步骤发出此 OID：

  1. Io 查询所需的缓冲区大小，发出 OID 查询，并将 NDIS_ISOLATION_PARAMETERS 结构的 Header 成员的 Size 成员设置为 NDIS_SIZEOF_NDIS_ISOLATION_PARAMETERS_REVISION_1。 (请参阅下面的 NDIS_STATUS_INVALID_LENGTH 。)
  2. 使用所需大小的 InformationBuffer 发出 OID。

如果 OID 查询请求成功完成，则 NDIS_OID_REQUEST 结构的 InformationBuffer 成员包含指向缓冲区的指针。 此缓冲区按顺序包含以下数据：

  1. NDIS_ISOLATION_PARAMETERS结构

  2. 一个或多个 NDIS_ROUTING_DOMAIN_ENTRY 结构，每个路由域各一个

  3. 一个或多个 NDIS_ROUTING_DOMAIN_ISOLATION_ENTRY 结构，按路由域分组

在每个NDIS_ROUTING_DOMAIN_ENTRY结构中，FirstIsolationInfoEntryOffset 成员包含与 OID 信息缓冲区开头 (即，NDIS_OID_REQUEST结构的 InformationBuffer 成员指向) 该路由域的第一个NDIS_ROUTING_DOMAIN_ISOLATION_ENTRY的缓冲区开头的偏移量。 列表中最后一个结构的 NextIsolationInfoEntryOffset 成员中的偏移量为零。

如果未在 VM 网络适配器上设置多租户配置参数，则网络适配器微型端口驱动程序将设置 DATA。QUERY_INFORMATION。NDIS_OID_REQUEST 结构的 BytesWritten 成员为零，并返回NDIS_STATUS_SUCCESS。 在本例中，为 DATA 中的数据。QUERY_INFORMATION。微型端口驱动程序不会修改 InformationBuffer 成员。

注解

返回状态代码

VM 网络适配器微型端口驱动程序为此 OID 请求返回以下状态代码之一：

状态代码 说明

NDIS_STATUS_SUCCESS

OID 请求已成功完成。

NDIS_STATUS_INVALID_LENGTH

信息缓冲区的长度太小，无法返回请求的信息。 VM 网络适配器微型端口驱动程序设置数据。METHOD_INFORMATION。NDIS_OID_REQUEST结构中的 BytesNeeded 成员达到所需的最小缓冲区大小（以字节为单位）。

NDIS_STATUS_FAILURE

请求因其他原因而失败。

要求

版本

在 NDIS 6.40 及更高版本中受支持。

标头

 Ntddndis.h (包括 Ndis.h)

另请参阅

NDIS_ISOLATION_PARAMETERS

NDIS_OID_REQUEST

NDIS_ROUTING_DOMAIN_ENTRY

NDIS_ROUTING_DOMAIN_ISOLATION_ENTRY

NDIS_STATUS_ISOLATION_PARAMETERS_CHANGE