структура NDIS_SWITCH_PORT_PROPERTY_PROFILE (ntddndis.h)

Статья
08/07/2023

Структура 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 , для члена Редакциизаголовка должно быть задано следующее значение:

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) OID_SWITCH_NIC_CREATE.

PciLocation

Структура, указывающая расположение pci базового физического сетевого адаптера, указанного членом NetCfgInstanceId .

Дополнительные сведения см. в разделе «Примечания».

PciLocation.PciSegmentNumber

Значение типа , указывающее группу шин PCI, к которой подключен физический сетевой адаптер.

PciLocation.PciBusNumber

Значение типа , указывающее текущий номер шины PCI, к которой подключен физический сетевой адаптер.

PciLocation.PciDeviceNumber

Значение типа , указывающее номер устройства для физического сетевого адаптера на шине PCI.

Примечание Номер устройства PCI также называется номером слота PCI.

PciLocation.PciFunctionNumber

Значение типа , указывающее номер функции логического устройства на физическом сетевом адаптере.

CdnLabelId

Значение UINT32, указывающее уникальный идентификатор данных, содержащихся в элементе CdnLabel .

CdnLabel

Значение NDIS_SWITCH_PORT_PROPERTY_PROFILE_CDN_LABEL, указывающее метку CDN PCI Express (PCIe) для расположения физического сетевого адаптера. Метка CDN предоставляет согласованные расположения устройств в аналогичных расположениях оборудования.

Структура NDIS_SWITCH_PORT_PROPERTY_PROFILE используется расширением для ссылки на свойство политики в частном хранилище политик, а не на хранилище политик Hyper-V. Это позволяет независимому поставщику программного обеспечения заполнять это частное хранилище политик и управлять ими через частные каналы и интерфейсы. Поставщики могут отличать свои профили от профилей других поставщиков с помощью полей VendorName и VendorId .

Примечание Свойства политики портов, заданные структурой NDIS_SWITCH_PORT_PROPERTY_PROFILE , прозрачны для интерфейса расширяемого коммутатора.

Структура NDIS_SWITCH_PORT_PROPERTY_PROFILE используется в следующих запросах на набор OID:

Структура NDIS_SWITCH_PORT_PROPERTY_PROFILE соответствует структуре NDIS_SWITCH_PORT_PROPERTY_PARAMETERS в буфере, связанной с этими запросами наборов OID. Элемент InformationBuffer структуры NDIS_OID_REQUEST содержит указатель на этот буфер.

Примечание Типы данных NDIS_SWITCH_PORT_PROPERTY_PROFILE_NAME и NDIS_SWITCH_PORT_PROPERTY_PROFILE_CDN_LABEL определяются IF_COUNTED_STRING структурой . Строка, определяемая этой структурой, не обязательно должна заканчиваться null. Однако длина строки должна быть задана в элементе Length этой структуры. Если строка заканчивается null, член Length не должен содержать завершающий символ NULL.

Члены PciLocation и CdnLabel актуальны, только если профиль свойства задает политику для базового физического сетевого адаптера, подключенного к внешнему сетевому адаптеру расширяемого коммутатора. Например, если внешний сетевой адаптер привязан к команде адаптеров с расширяемым коммутатором, эти участники могут указать политики для одного адаптера из этой команды. Дополнительные сведения о команде расширяемых коммутаторов см. в разделе Типы конфигураций физических сетевых адаптеров.

Требования

Требование	Значение
Минимальная версия клиента	Поддерживается в NDIS 6.30 и более поздних версиях.
Верхняя часть	ntddndis.h (включая Ndis.h)