OID_RECEIVE_FILTER_CLEAR_FILTER

Статья
06/15/2023

Чрезмерные драйверы выдают запросы на настройку OID OID_RECEIVE_FILTER_CLEAR_FILTER для очистки фильтра получения в сетевом адаптере.

Элемент InformationBuffer структуры NDIS_OID_REQUEST содержит указатель на структуру NDIS_RECEIVE_FILTER_CLEAR_PARAMETERS .

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

Запрос набора OID OID_RECEIVE_FILTER_CLEAR_FILTER является обязательным для драйверов мини-портов, поддерживающих объединение пакетов NDIS, SR-IOV или VMQ.

Для очистки ранее заданного фильтра драйвер, например драйвер протокола NDIS или фильтра, использует запрос OID_RECEIVE_FILTER_CLEAR_FILTER set. Очистить его может только драйвер, задал фильтр получения.

Драйвер overlying очищает фильтр получения, задавая для элемента FilterId структуры NDIS_RECEIVE_FILTER_CLEAR_PARAMETERS идентификатор фильтра. Драйвер получил идентификатор фильтра из предыдущего запроса метода OID OID_RECEIVE_FILTER_SET_FILTER.

Дополнительные инструкции для объединения пакетов NDIS

Следующий момент относится к драйверам miniport и overlying, поддерживающим объединение пакетов NDIS:

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

Дополнительные рекомендации по интерфейсу SR-IOV

Следующие моменты относятся к мини-портам и драйверам overlying, поддерживающим интерфейс SR-IOV.

Прежде чем освободить VPort, драйвер должен очистить все фильтры, заданные в SR-IOV VPort. Прежде чем закрыть привязку к сетевому адаптеру, драйвер должен очистить все фильтры, заданные в VPort по умолчанию.
Драйвер мини-порта не должен указывать пакеты в неразрушаемом VPort, если он завершил запрос OID OID_RECEIVE_FILTER_CLEAR_FILTER для очистки последнего фильтра в VPort.

Примечание Драйвер мини-порта также не должен указывать пакеты в нестандартном VPort, если он завершил запрос OID OID_NIC_SWITCH_DELETE_VPORT для освобождения VPort.

Дополнительные рекомендации по интерфейсу VMQ

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

Прежде чем освободить очередь, драйвер должен очистить все фильтры, заданные в очереди получения VMQ. Прежде чем закрыть привязку к сетевому адаптеру, драйвер должен очистить все фильтры, заданные в очереди по умолчанию.
Драйвер мини-порта не должен указывать пакеты в очереди получения, если он завершил запрос OID OID_RECEIVE_FILTER_CLEAR_FILTER для очистки последнего фильтра в очереди получения.

Примечание Драйвер мини-порта также не должен указывать пакеты в очереди получения, если он завершил запрос OID OID_RECEIVE_FILTER_FREE_QUEUE для освобождения очереди получения.

Коды состояния возврата

Функция MiniportOidRequest драйвера miniport возвращает одно из следующих значений для этого запроса:

Термин	Описание
NDIS_STATUS_SUCCESS	Драйвер мини-порта успешно выполнил запрос.
NDIS_STATUS_PENDING	Драйвер мини-порта выполнит запрос асинхронно. После того как драйвер мини-порта завершит всю обработку, он должен выполнить запрос, вызвав функцию NdisMOidRequestComplete , передав NDIS_STATUS_SUCCESS для параметра Status .
NDIS_STATUS_NOT_ACCEPTED	Адаптер мини-порта был неожиданно удален.

NDIS возвращает один из следующих кодов состояния для этого запроса:

NDIS_STATUS_SUCCESS
Указанный фильтр успешно очищен.

NDIS_STATUS_PENDING
Запрос ожидает завершения. NDIS передает окончательный код состояния и результаты обработчику завершения запроса OID вызывающего объекта после завершения запроса.

NDIS_STATUS_FILE_NOT_FOUND
Недопустимый идентификатор фильтра.

NDIS_STATUS_INVALID_LENGTH
Буфер информации слишком мал. NDIS задает DATA. SET_INFORMATION. Элемент BytesNeeded в NDIS_OID_REQUEST структуру до минимального требуемого размера буфера.

Требования

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