OID_RECEIVE_FILTER_PARAMETERS
Избывляющий драйвер отправляет запрос метода OID OID_RECEIVE_FILTER_PARAMETERS для получения текущих параметров конфигурации фильтра сетевого адаптера.
Элемент InformationBuffer структуры NDIS_OID_REQUEST содержит указатель на структуру NDIS_RECEIVE_FILTER_PARAMETERS . NDIS использует элемент FilterId во входной структуре для идентификации фильтра.
После успешного возврата из запроса метода OID элемент InformationBufferструктуры NDIS_OID_REQUEST содержит указатель на буфер. Этот буфер имеет следующий формат:
Структура NDIS_RECEIVE_FILTER_PARAMETERS , указывающая параметры для фильтра получения NDIS.
Массив NDIS_RECEIVE_FILTER_FIELD_PARAMETERS структур, указывающий критерий проверки фильтра для поля в заголовке сетевого пакета.
Комментарии
Фильтры получения NDIS используются в следующих интерфейсах NDIS:
Объединение пакетов NDIS. Дополнительные сведения об использовании фильтров получения в этом интерфейсе см. в разделе Управление фильтрами получения объединения пакетов.
Виртуализация одно корневых операций ввода-вывода (SR-IOV). Дополнительные сведения об использовании фильтров получения в этом интерфейсе см. в разделе Настройка фильтра получения для виртуального порта.
Очередь виртуальных машин (VMQ). Дополнительные сведения об использовании фильтров получения в этом интерфейсе см. в разделе Настройка и очистка фильтров VMQ.
Избыточные драйверы выдают запросы метода OID OID_RECEIVE_FILTER_PARAMETERS для получения параметров конфигурации для фильтра приема, заданного для сетевого адаптера. Сюда входит фильтр приема, который был задан для очереди получения VMQ или виртуального порта SR-IOV (VPort), а также фильтр объединения пакетов, скачанный в драйвер мини-порта.
Драйвер overlying получил идентификатор фильтра из предыдущего запроса метода OID OID_RECEIVE_FILTER_SET_FILTER или из запросов OID OID_RECEIVE_FILTER_ENUM_FILTERS.
Коды состояния возврата
NDIS обрабатывает запрос OID OID_RECEIVE_FILTER_PARAMETERS для водителей мини-портов и возвращает один из следующих кодов состояния:
NDIS_STATUS_SUCCESS
Запрос успешно завершен. InformationBuffer указывает на структуру NDIS_RECEIVE_FILTER_PARAMETERS.
NDIS_STATUS_PENDING
Запрос ожидает завершения. NDIS передает окончательный код состояния и результаты обработчику завершения запроса OID вызывающего объекта после завершения запроса.
NDIS_STATUS_INVALID_PARAMETER
Переопределяющий драйвер или приложение предоставили недопустимый идентификатор фильтра. Недопустимый идентификатор фильтра, если он равен нулю или указывает неопределенный фильтр.
NDIS_STATUS_INVALID_LENGTH
Буфер сведений был слишком коротким. NDIS задает значение DATA. QUERY_INFORMATION. Элемент BytesNeeded в NDIS_OID_REQUEST структуру до минимального требуемого размера буфера.
NDIS_STATUS_FAILURE
Сбой запроса по другим причинам.
Требования
Версия |
Поддерживается в NDIS 6.20 и более поздних версиях. |
Заголовок |
Ntddndis.h (включая Ndis.h) |
См. также раздел
OID_RECEIVE_FILTER_ENUM_FILTERS