共用方式為


NDIS_SWITCH_PORT_PARAMETERS結構 (ntddndis.h)

NDIS_SWITCH_PORT_PARAMETERS 結構包含 Hyper-V 可延伸交換器埠的組態數據。

語法

typedef struct _NDIS_SWITCH_PORT_PARAMETERS {
  NDIS_OBJECT_HEADER            Header;
  ULONG                         Flags;
  NDIS_SWITCH_PORT_ID           PortId;
  NDIS_SWITCH_PORT_NAME         PortName;
  NDIS_SWITCH_PORT_FRIENDLYNAME PortFriendlyName;
  NDIS_SWITCH_PORT_TYPE         PortType;
  BOOLEAN                       IsValidationPort;
  NDIS_SWITCH_PORT_STATE        PortState;
} NDIS_SWITCH_PORT_PARAMETERS, *PNDIS_SWITCH_PORT_PARAMETERS;

成員

Header

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

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

NDIS_SWITCH_PORT_PARAMETERS_REVISION_1

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

Size 成員設定為 NDIS_SIZEOF_NDIS_SWITCH_PORT_PARAMETERS_REVISION_1。

Flags

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

PortId

NDIS_SWITCH_PORT_ID值,其中包含可延伸交換器埠的唯一標識碼。

PortName

NDIS_SWITCH_PORT_NAME值,指定可延伸交換器埠的唯一內部名稱。

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

PortFriendlyName

NDIS_SWITCH_PORT_FRIENDLYNAME值,指定可延伸交換器埠的用戶易記描述。

PortType

指定可延伸交換器埠類型的 NDIS_SWITCH_PORT_TYPE 值。

IsValidationPort

如果為 TRUE,表示在建立 VM 網路適配器連線之前,暫時建立供測試和驗證之用的埠。 如您需要此連接埠類型的詳細資訊,請參閱 驗證埠

PortState

指定埠目前狀態的 NDIS_SWITCH_PORT_STATE 值。

言論

InformationBufferNDIS_OID_REQUEST 結構的成員包含下列 OID 要求的 NDIS_SWITCH_PORT_PARAMETERS 結構的指標:

OID_SWITCH_PORT_ARRAY 的 OID 查詢要求會傳回包含元素陣列的 NDIS_SWITCH_PORT_ARRAY 結構。 每個元素都會格式化為 NDIS_SWITCH_PORT_PARAMETERS 結構。

可延伸的交換器延伸模組可以使用 NDIS_SWITCH_PORT_AT_ARRAY_INDEX 巨集,存取 NDIS_SWITCH_PORT_PARAMETERS 結構內的埠屬性緩衝區。

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

要求

要求 價值
最低支援的用戶端 NDIS 6.30 和更新版本支援。
標頭 ntddndis.h (include Ndis.h, Fwpsk.h)

另請參閱

IF_COUNTED_STRING

NDIS_OBJECT_HEADER

NDIS_OID_REQUEST

NDIS_SWITCH_PORT_ARRAY

NDIS_SWITCH_PORT_AT_ARRAY_INDEX

NDIS_SWITCH_PORT_PARAMETERS

NDIS_SWITCH_PORT_STATE

NDIS_SWITCH_PORT_TYPE

OID_SWITCH_PORT_ARRAY

OID_SWITCH_PORT_CREATE

OID_SWITCH_PORT_DELETE

OID_SWITCH_PORT_TEARDOWN