NDIS_SWITCH_PORT_PROPERTY_PROFILE結構（ntddndis.h）

發行項
02/07/2025

NDIS_SWITCH_PORT_PROPERTY_PROFILE 結構會指定可延伸交換器擴充功能儲存在其自己的原則存放區中，而不是在 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 結構。

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

NDIS_SWITCH_PORT_PROPERTY_PROFILE_REVISION_1

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

將 Size 成員設定為 NDIS_SIZEOF_NDIS_SWITCH_PROPERTY_PROFILE_REVISION_1。

Flags

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

ProfileName

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

ProfileId

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

VendorName

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

VendorId

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

ProfileData

NetCfgInstanceId

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

NetCfgInstanceId 值是透過 OID_SWITCH_NIC_CREATE的物件識別碼（OID）集要求，為網路適配器連線指定。

PciLocation

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

如需詳細資訊，請參閱一節。

PciLocation.PciSegmentNumber

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

PciLocation.PciBusNumber

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

PciLocation.PciDeviceNumber

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

附註 PCI 裝置號碼也稱為 PCI 插槽號碼。

PciLocation.PciFunctionNumber

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

CdnLabelId

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

CdnLabel

NDIS_SWITCH_PORT_PROPERTY_PROFILE_CDN_LABEL值，指定實體網路適配器位置的PCI Express （PCIe） CDN 標籤。 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 結構。 InformationBufferNDIS_OID_REQUEST 結構的成員包含這個緩衝區的指標。

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

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