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 结构。

标头的类型成员必须设置为NDIS_OBJECT_TYPE_DEFAULT。若要指定 NDIS_SWITCH_PORT_PROPERTY_PROFILE 结构的版本，必须将标头修订版 成员设置为以下值：

NDIS_SWITCH_PORT_PROPERTY_PROFILE_REVISION_1

NDIS 6.30 及更高版本的原始版本。

将大小成员设置为NDIS_SIZEOF_NDIS_SWITCH_PROPERTY_PROFILE_REVISION_1。

Flags

包含标志的按位或的 ULONG 值。此成员保留为 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 结构。 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 成员才相关。例如，如果外部网络适配器绑定到可扩展交换机适配器团队，则这些成员可以为该团队中的单个适配器指定策略。有关可扩展交换机团队的详细信息，请参阅类型的物理网络适配器配置。