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

Статья
02/26/2024

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

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

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

Синтаксис

typedef struct _NDIS_RECEIVE_FILTER_INFO {
  NDIS_OBJECT_HEADER       Header;
  ULONG                    Flags;
  NDIS_RECEIVE_FILTER_TYPE FilterType;
  NDIS_RECEIVE_FILTER_ID   FilterId;
} NDIS_RECEIVE_FILTER_INFO, *PNDIS_RECEIVE_FILTER_INFO;

Члены

Header

Структура NDIS_OBJECT_HEADER для структуры NDIS_RECEIVE_FILTER_INFO . Драйвер задает элемент Type структуры, указанной в заголовке , для NDIS_OBJECT_TYPE_DEFAULT.

Чтобы указать версию структуры NDIS_RECEIVE_FILTER_INFO , драйвер задает члену Revision одно из следующих значений:

NDIS_RECEIVE_FILTER_INFO_REVISION_1

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

Драйвер задает для элемента Size значение NDIS_SIZEOF_RECEIVE_FILTER_INFO_REVISION_1.

Flags

Побитовое ИЛИ флагов. Этот элемент зарезервирован для NDIS.

FilterType

Тип фильтра получения.

FilterId

Идентификатор фильтра получения. Идентификатор фильтра — это целое число от единицы до количества фильтров приема, поддерживаемых сетевым адаптером. Недопустимое значение, равное нулю.

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

Требования

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

См. также раздел

NDIS_OBJECT_HEADER

NDIS_RECEIVE_FILTER_INFO_ARRAY

OID_RECEIVE_FILTER_ENUM_FILTERS

Поделиться через