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

Статья
08/07/2023

Структура NDIS_SRIOV_CAPABILITIES определяет возможности однокорневой виртуализации ввода-вывода (SR-IOV) сетевого адаптера.

Синтаксис

typedef struct _NDIS_SRIOV_CAPABILITIES {
  NDIS_OBJECT_HEADER Header;
  ULONG              Flags;
  ULONG              SriovCapabilities;
} NDIS_SRIOV_CAPABILITIES, *PNDIS_SRIOV_CAPABILITIES;

Члены

Header

Тип, редакция и размер структуры NDIS_SRIOV_CAPABILITIES . Этот элемент имеет формат структуры NDIS_OBJECT_HEADER .

Драйвер мини-порта должен задать для элемента Typeзаголовка значение NDIS_OBJECT_TYPE_DEFAULT. Чтобы указать версию структуры NDIS_SRIOV_CAPABILITIES , драйвер должен задать для члена Редакциизаголовка следующее значение:

NDIS_SRIOV_CAPABILITIES _REVISION_1

Исходная версия для NDIS 6.30 и более поздних версий.

Задайте для элемента Размер значение NDIS_SIZEOF_SRIOV_CAPABILITIES _REVISION_1.

Flags

Значение ULONG, содержащее побитовое ИЛИ флагов. Этот элемент зарезервирован для NDIS

SriovCapabilities

Значение ULONG, содержащее побитовое ЗНАЧЕНИЕ ИЛИ следующих флагов:

NDIS_SRIOV_CAPS_SRIOV_SUPPORTED

Указывает, что сетевой адаптер поддерживает функции SR-IOV.

Примечание Этот флаг должен устанавливаться только драйвером мини-порта для физической функции (PF) PCI Express (PCIe) сетевого адаптера. Этот драйвер выполняется в операционной системе управления. Эта операционная система работает в родительском разделе Hyper-V.

NDIS_SRIOV_CAPS_PF_MINIPORT

Указывает, что это драйвер мини-порта PF.

NDIS_SRIOV_CAPS_VF_MINIPORT

Указывает, что это драйвер мини-порта виртуальной функции PCIe (VF).

Драйвер мини-порта вызывает функцию NdisMSetMiniportAttributes из своей функции MiniportInitializeEx и задает параметру MiniportAttributes указатель на структуру NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES . Драйвер объявляет поддержку SR-IOV путем форматирования элементов HardwareSriovCapabilities и CurrentSriovCapabilities как NDIS_SRIOV_CAPABILITIES структур.
Когда драйвер успешно обрабатывает запрос OID OID_SRIOV_HARDWARE_CAPABILITIES или OID_SRIOV_CURRENT_CAPABILITIES, он возвращает NDIS_SRIOV_CAPABILITIES структуру.

NDIS передает возможности SR-IOV сетевого адаптера в более уровневые драйверы, которые привязываются к сетевому адаптеру следующим образом:

Когда NDIS вызывает функцию FilterAttach драйвера избыточного фильтра, NDIS передает возможности SR-IOV сетевого адаптера через параметр AttachParameters . Этот параметр содержит указатель на структуру NDIS_FILTER_ATTACH_PARAMETERS . Элемент SriovCapabilities этой структуры содержит указатель на NDIS_SRIOV_CAPABILITIES структуру.
Когда NDIS вызывает функцию ProtocolBindAdapterEx драйвера чрезмерного протокола, NDIS передает возможности SR-IOV сетевого адаптера через параметр BindParameters . Этот параметр содержит указатель на структуру NDIS_FILTER_ATTACH_PARAMETERS . Элемент SriovCapabilities этой структуры содержит указатель на NDIS_SRIOV_CAPABILITIES структуру.

Дополнительные сведения о том, как сообщить о возможностях SR-IOV сетевого адаптера, см. в разделе Определение возможностей SR-IOV.

Требования

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