NDIS_SWITCH_NIC_OID_REQUEST 結構 (ntddndis.h)

發行項
03/05/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結構的版本，標頭的 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 要求轉送到可延伸交換器驅動程式堆疊中的基礎實體網路配接器。這可讓擴充功能執行下列動作：

針對下列卸除技術，管理基礎實體適配卡上的硬體卸載設定：
- 因特網通訊協定安全性 (IPsec) 。
- 虛擬機佇列 (VMQ) 。
- 單一根目錄 I/O 虛擬化 (SR-IOV)。
發出標準 NDIS OID 來查詢基礎實體網路適配器的設定。例如，擴充功能可以發出 OID_802_3_CURRENT_ADDRESS 的 OID 查詢要求，以取得適配卡的目前媒體訪問控制 (MAC) 位址。

如需如何對基礎實體適配卡發出 OID 要求的指導方針，請參閱管理實體網路適配器的 OID 要求。