共用方式為


NDIS_SWITCH_PARAMETERS結構 (ntddndis.h)

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 結構。

HeaderType 成員必須設定為 NDIS_OBJECT_TYPE_DEFAULT。 若要指定NDIS_SWITCH_PARAMETERS結構的版本,標頭Revision 成員必須設定為下列值:

NDIS_SWITCH_PARAMETERS_REVISION_1

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

Size 成員設定為 NDIS_SIZEOF_NDIS_SWITCH_PARAMETERS_REVISION_1。

Flags

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

SwitchName

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

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

SwitchFriendlyName

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

NumSwitchPorts

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

IsActive

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

備註

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

此結構也會傳入下列 Windows 篩選平台圖說文字驅動程式之註標函式的 vSwitch 參數:

注意NDIS_SWITCH_NAMENDIS_SWITCH_FRIENDLYNAME數據類型是由IF_COUNTED_STRING結構所定義。 這個結構所定義的字串不需要以 Null 結束。 不過,字串的長度必須在這個 結構的 Length 成員中設定。 如果字串為 Null 終止, Length 成員不得包含終止的 Null 字元。
 

規格需求

需求
最低支援的用戶端 NDIS 6.30 和更新版本支援。
標頭 ntddndis.h (包含 Ndis.h、Fwpsk.h)

另請參閱

FWPS_VSWITCH_LIFETIME_EVENT_CALLBACK0

FWPS_VSWITCH_POLICY_EVENT_CALLBACK0

FWPS_VSWITCH_PORT_EVENT_CALLBACK0

FWPS_VSWITCH_RUNTIME_STATE_RESTORE_CALLBACK0

FWPS_VSWITCH_RUNTIME_STATE_SAVE_CALLBACK0

IF_COUNTEDFWPS_VSWITCH_INTERFACE_EVENT_CALLBACK0

NDIS_OBJECT_HEADER

NetEventSwitchActivate

OID_SWITCH_PARAMETERS

_字串