NDIS_SWITCH_PORT_PROPERTY_PROFILE 结构 (ntddndis.h)

项目
03/05/2024

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结构的版本，必须将 Header 的 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

一个 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 成员才相关。例如，如果外部网络适配器绑定到适配器的可扩展交换机组，则这些成员可以为该团队中的单个适配器指定策略。有关可扩展交换机团队的详细信息，请参阅物理网络适配器配置的类型。