NDIS_SWITCH_PORT_PROPERTY_PROFILE 結構 (ntddndis.h)

發行項
03/01/2024

NDIS_SWITCH_PORT_PROPERTY_PROFILE 結構會指定 Hyper-V 可延伸交換器擴充功能儲存在其原則存放區而非 Hyper-V 原則存放區中之 Hyper-V 可延伸交換器埠的原則屬性。在此情況下，原則定義是由驅動程序原則存放區中的屬性配置檔所識別。

語法

typedef struct _NDIS_SWITCH_PORT_PROPERTY_PROFILE {
  NDIS_OBJECT_HEADER                          Header;
  ULONG                                       Flags;
  NDIS_SWITCH_PORT_PROPERTY_PROFILE_NAME      ProfileName;
  GUID                                        ProfileId;
  NDIS_VENDOR_NAME                            VendorName;
  GUID                                        VendorId;
  UINT32                                      ProfileData;
  GUID                                        NetCfgInstanceId;
  struct {
    UINT32 PciSegmentNumber : 16;
    UINT32 PciBusNumber : 8;
    UINT32 PciDeviceNumber : 5;
    UINT32 PciFunctionNumber : 3;
  } PciLocation;
  UINT32                                      CdnLabelId;
  NDIS_SWITCH_PORT_PROPERTY_PROFILE_CDN_LABEL CdnLabel;
} NDIS_SWITCH_PORT_PROPERTY_PROFILE, *PNDIS_SWITCH_PORT_PROPERTY_PROFILE;

成員

Header

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

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

NDIS_SWITCH_PORT_PROPERTY_PROFILE_REVISION_1

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

將 Size 成員設定為 NDIS_SIZEOF_NDIS_SWITCH_PROPERTY_PROFILE_REVISION_1。

Flags

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

ProfileName

NDIS_SWITCH_PORT_PROPERTY_PROFILE_NAME值，指定配置檔屬性的用戶易記名稱。

ProfileId

可唯一識別配置檔屬性的 GUID 值。

VendorName

NDIS_VENDOR_NAME值，指定定義埠配置檔之廠商的用戶易記名稱。

VendorId

GUID 值，識別定義埠配置檔的廠商。

ProfileData

NetCfgInstanceId

GUID 值，指定套用屬性之基礎網路適配器連線的 NetCfgInstanceId 登錄值。

NetCfgInstanceId 值是透過物件識別元指定給網路適配器連線， (OID) 設定OID_SWITCH_NIC_CREATE的要求。

PciLocation

結構，指定 NetCfgInstanceId 成員所指定基礎實體網路適配器的 PCI 位置。

如需詳細資訊，請參閱＜備註＞一節。

PciLocation.PciSegmentNumber

值，指定附加實體網路適配器的PCI總線群組。

PciLocation.PciBusNumber

值，指定實體網路適配器所連接的目前PCI總線號碼。

PciLocation.PciDeviceNumber

值，指定PCI總線上實體網路適配器的裝置號碼。

注意 PCI 裝置號碼也稱為 PCI插槽號碼。

PciLocation.PciFunctionNumber

值，指定實體網路適配器上邏輯裝置的函式編號。

CdnLabelId

UINT32 值，指定 CdnLabel 成員中包含的數據的唯一標識碼。

CdnLabel

指定實體網路適配器位置之PCI Express (PCIe) CDN 標籤的 NDIS_SWITCH_PORT_PROPERTY_PROFILE_CDN_LABEL 值。 CDN 標籤可在類似的硬體位置之間提供一致的裝置位置。

備註

擴充功能會使用 NDIS_SWITCH_PORT_PROPERTY_PROFILE 結構來參考私人原則存放區內的原則屬性，而不是 Hyper-V 原則存放區。這可讓獨立軟體廠商 (ISV) 透過私人頻道和介面填入和管理此私人原則存放區。廠商可以使用 VendorName 和 VendorId 欄位，區分其配置檔與其他廠商的配置檔。

注意NDIS_SWITCH_PORT_PROPERTY_PROFILE結構所指定的埠原則屬性對可延伸交換器介面而言是透明的。

NDIS_SWITCH_PORT_PROPERTY_PROFILE 結構用於下列 OID 集合要求：

NDIS_SWITCH_PORT_PROPERTY_PROFILE 結構遵循與這些 OID 集合要求相關聯的緩衝區中的NDIS_SWITCH_PORT_PROPERTY_PARAMETERS結構。 NDIS_OID_REQUEST 結構的 InformationBuffer 成員包含這個緩衝區的指標。

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

PciLocation 和 CdnLabel 成員只有在屬性配置檔指定附加至可延伸交換器外部網路適配器之基礎實體網路適配器的原則時才相關。例如，如果外部網路適配器系結至適配卡的可延伸交換器小組，這些成員可以從該小組指定單一適配卡的原則。如需可延伸交換器小組的詳細資訊，請參閱實體網路適配器組態的類型。