NDIS_SWITCH_PARAMETERS結構（ntddndis.h）

發行項
02/07/2025

NDIS_SWITCH_PARAMETERS 結構包含 Hyper-V 可延伸參數的組態數據。

語法

typedef struct _NDIS_SWITCH_PARAMETERS {
  NDIS_OBJECT_HEADER       Header;
  ULONG                    Flags;
  NDIS_SWITCH_NAME         SwitchName;
  NDIS_SWITCH_FRIENDLYNAME SwitchFriendlyName;
  UINT32                   NumSwitchPorts;
  BOOLEAN                  IsActive;
} NDIS_SWITCH_PARAMETERS, *PNDIS_SWITCH_PARAMETERS;

成員

Header

NDIS_SWITCH_PARAMETERS 結構的型別、修訂和大小。此成員的格式為 NDIS_OBJECT_HEADER 結構。

標頭的 Type 成員必須設定為 NDIS_OBJECT_TYPE_DEFAULT。若要指定 NDIS_SWITCH_PARAMETERS 結構的版本，Revision member of Header 必須設定為下列值：

NDIS_SWITCH_PARAMETERS_REVISION_1

NDIS 6.30 和更新版本的原始版本。

將 Size 成員設定為 NDIS_SIZEOF_NDIS_SWITCH_PARAMETERS_REVISION_1。

Flags

ULONG 值，其中包含旗標的位 OR。此成員保留給 NDIS。

SwitchName

NDIS_SWITCH_NAME 值，指定可延伸參數的唯一內部名稱。

以WMI為基礎的原則管理應用程式會使用內部交換器名稱。如需詳細資訊，請參閱管理 Hyper-V 可延伸交換器原則。

SwitchFriendlyName

NDIS_SWITCH_FRIENDLYNAME 值，指定可延伸參數的用戶易記描述。

NumSwitchPorts

UINT32 值，指定可延伸交換器上設定的埠數目。

IsActive

BOOLEAN，如果 TRUE 表示 Hyper-V 可延伸交換器啟用已完成，而且可以安全地查詢其他交換器組態，例如列舉埠、NIC 和屬性。如果為 FALSE，擴充功能必須等候 NetEventSwitchActivate PNP 事件，再查詢交換器組態。

言論

NDIS_SWITCH_PARAMETERS 結構用於 OID_SWITCH_PARAMETERS的 OID 要求中。

此結構也會在 Windows 篩選平台圖說驅動程式的下列註標函式的 vSwitch 參數中傳遞：

附註NDIS_SWITCH_NAME 和 NDIS_SWITCH_FRIENDLYNAME 數據類型是由 IF_COUNTED_STRING 結構所定義。這個結構所定義的字串不必以 Null 結尾。不過，字串的長度必須在這個結構的 Length 成員中設定。如果字串為 null 終止，則 Length 成員不得包含終止的 Null 字元。