NDIS_SWITCH_NIC_OID_REQUEST 结构 (ntddndis.h)

项目
02/29/2024

NDIS_SWITCH_NIC_OID_REQUEST 结构指定转发或发起 OID 请求所需的信息。

语法

typedef struct _NDIS_SWITCH_NIC_OID_REQUEST {
  NDIS_OBJECT_HEADER    Header;
  ULONG                 Flags;
  NDIS_SWITCH_PORT_ID   SourcePortId;
  NDIS_SWITCH_NIC_INDEX SourceNicIndex;
  NDIS_SWITCH_PORT_ID   DestinationPortId;
  NDIS_SWITCH_NIC_INDEX DestinationNicIndex;
  PNDIS_OID_REQUEST     OidRequest;
} NDIS_SWITCH_NIC_OID_REQUEST, *PNDIS_SWITCH_NIC_OID_REQUEST;

成员

Header

NDIS_SWITCH_NIC_OID_REQUEST 结构的类型、修订和大小。此成员的格式设置为 NDIS_OBJECT_HEADER 结构。

Header 的 Type 成员必须设置为 NDIS_OBJECT_TYPE_DEFAULT。若要指定 NDIS_SWITCH_NIC_OID_REQUEST 结构的版本，必须将 Header 的 Revision 成员设置为以下值：

NDIS_SWITCH_NIC_OID_REQUEST_REVISION_1

NDIS 6.30 及更高版本的原始版本。

将 Size 成员设置为NDIS_SIZEOF_NDIS_SWITCH_NIC_OID_REQUEST_REVISION_1。

Flags

包含标志的按位 OR 的 ULONG 值。此成员是为 NDIS 保留的。

SourcePortId

一个 NDIS_SWITCH_PORT_ID 值，该值包含最初发出 OID 请求的 Hyper-V 可扩展交换机端口的唯一标识符。

SourceNicIndex

一个 NDIS_SWITCH_NIC_INDEX 值，该值指定连接到 SourcePortId 成员指定的源可扩展交换机端口的源网络适配器的索引。

DestinationPortId

一个 NDIS_SWITCH_PORT_ID 值，该值包含 OID 请求将转发到的可扩展交换机端口的唯一标识符。

DestinationNicIndex

一个 NDIS_SWITCH_NIC_INDEX 值，该值指定连接到 由 DestinationPortId 成员指定的可扩展交换机端口的目标网络适配器的索引。

OidRequest

指向 NDIS_OID_REQUEST 结构的指针。此结构包含 OID 请求的数据，该请求将转发到 由 DestinationPortId 和 DestinationNicIndex 成员指定的网络适配器的微型端口驱动程序。

注解

NDIS_SWITCH_NIC_OID_REQUEST 结构用于 OID_SWITCH_NIC_REQUEST 的 OID 方法请求。

扩展可以将 OID 请求转发或发起到可扩展交换机驱动程序堆栈中的基础物理网络适配器。这使扩展能够执行以下操作：

管理以下卸载技术的基础物理适配器上的硬件卸载配置：
- Internet 协议安全 (IPsec) 。
- 虚拟机队列 (VMQ) 。
- 单根 I/O 虚拟化 (SR-IOV)。
通过发出标准 NDIS OID 来查询基础物理网络适配器的配置。例如，扩展可以发出 OID_802_3_CURRENT_ADDRESS 的 OID 查询请求，以获取适配器的当前媒体访问控制 (MAC) 地址。

有关如何向基础物理适配器发出 OID 请求的指南，请参阅管理对物理网络适配器的 OID 请求。