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

Статья
08/07/2023

Структура NDIS_RECEIVE_FILTER_INFO_ARRAY указывает список фильтров получения, настроенных в настоящее время в драйвере мини-порта.

Фильтры получения NDIS используются в следующих интерфейсах NDIS:

Объединение пакетов NDIS. Дополнительные сведения об использовании фильтров получения в этом интерфейсе см. в разделе Управление фильтрами получения объединения пакетов.
Виртуализация однокорневого ввода-вывода (SR-IOV). Дополнительные сведения об использовании фильтров получения в этом интерфейсе см. в статье Настройка фильтра получения для виртуального порта.
Очередь виртуальных машин (VMQ). Дополнительные сведения об использовании фильтров получения в этом интерфейсе см. в разделе Настройка и очистка фильтров VMQ.

Синтаксис

typedef struct _NDIS_RECEIVE_FILTER_INFO_ARRAY {
  NDIS_OBJECT_HEADER       Header;
  NDIS_RECEIVE_QUEUE_ID    QueueId;
  ULONG                    FirstElementOffset;
  ULONG                    NumElements;
  ULONG                    ElementSize;
  ULONG                    Flags;
  NDIS_NIC_SWITCH_VPORT_ID VPortId;
} NDIS_RECEIVE_FILTER_INFO_ARRAY, *PNDIS_RECEIVE_FILTER_INFO_ARRAY;

Члены

Header

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

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

NDIS_SIZEOF_RECEIVE_FILTER_INFO_ARRAY_REVISION_2

Добавлены члены для NDIS 6.30.

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

NDIS_SIZEOF_RECEIVE_FILTER_INFO_ARRAY_REVISION_1

Исходная версия для NDIS 6.20.

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

QueueId

Идентификатор очереди получения. Этот идентификатор представляет собой целое число от нуля до количества очередей, поддерживаемых сетевым адаптером. Значение NDIS_DEFAULT_RECEIVE_QUEUE_ID указывает очередь получения по умолчанию.

Примечание Драйверы miniport, поддерживающие объединение пакетов NDIS или интерфейс SR-IOV, должны задать для члена QueueId значение NDIS_DEFAULT_RECEIVE_QUEUE_ID.

FirstElementOffset

Смещение (в байтах) к первому элементу в массиве элементов, которые следуют за этой структурой. Смещение измеряется от начала структуры NDIS_RECEIVE_FILTER_INFO_ARRAY до начала первого элемента. Каждый элемент в массиве является NDIS_RECEIVE_FILTER_INFO структурой.

Примечание Если numElements равно нулю, этот элемент игнорируется.

NumElements

Количество элементов в массиве.

ElementSize

Размер в байтах каждого элемента массива.

Flags

Побитовое ИЛИ следующих флагов:

NDIS_RECEIVE_FILTER_INFO_ARRAY_VPORT_ID_SPECIFIED

Если этот флаг установлен, запрашиваются сведения о фильтрах получения, настроенных на виртуальном порту (VPort), указанном членом VPortId .

Примечание Этот флаг действителен только для интерфейса SR-IOV.

VPortId

Идентификатор виртуального порта (VPort), к которому запрашиваются фильтры получения. Идентификатор VPort должен иметь одно из следующих значений:

Идентификатор VPort, который ранее был выделен с помощью запроса метода OID OID_NIC_SWITCH_CREATE_VPORT.
Значение NDIS_DEFAULT_VPORT_ID, указывающее VPort по умолчанию для коммутатора сетевой карты.

Сетевой коммутатор поддерживается сетевыми адаптерами для интерфейса SR-IOV. Для коммутатора сетевого адаптера можно настроить один или несколько виртуальных портов.

Примечание Член VPortId действителен, только если флаг NDIS_RECEIVE_FILTER_INFO_ARRAY_VPORT_ID_SPECIFIED установлен в разделе Флаги.

Структура NDIS_RECEIVE_FILTER_INFO_ARRAY используется в запросе OID OID_RECEIVE_FILTER_ENUM_FILTERS. Этот запрос OID перечисляет фильтры получения в очереди получения VMQ или SR-IOV. Каждый элемент массива, следующий за структурой NDIS_RECEIVE_FILTER_INFO_ARRAY , является структура NDIS_RECEIVE_FILTER_INFO .

Требования

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