OID_RECEIVE_FILTER_CURRENT_CAPABILITIES
Избыточные драйверы выдают запросы OID OID_RECEIVE_FILTER_CURRENT_CAPABILITIES для получения включенных в настоящее время возможностей фильтрации получения сетевого адаптера.
После успешного возврата из запроса OID элемент InformationBuffer структуры NDIS_OID_REQUEST содержит указатель на NDIS_RECEIVE_FILTER_CAPABILITIES структуру.
Комментарии
Фильтры получения NDIS используются в следующих интерфейсах NDIS:
Объединение пакетов NDIS. Дополнительные сведения об использовании фильтров получения в этом интерфейсе см. в разделе Управление фильтрами получения объединения пакетов.
Виртуализация однокорневого ввода-вывода (SR-IOV). Дополнительные сведения об использовании фильтров получения в этом интерфейсе см. в статье Настройка фильтра получения для виртуального порта.
Очередь виртуальных машин (VMQ). Дополнительные сведения об использовании фильтров получения в этом интерфейсе см. в разделе Настройка и очистка фильтров VMQ.
Начиная с версии NDIS 6.20, драйверы минипорта регистрируют включенные в настоящее время аппаратные возможности фильтрации приема сетевого адаптера при вызове его функции MiniportInitializeEx . Драйверы мини-портов регистрируют эти возможности, выполнив следующие действия.
Драйвер инициализирует структуру NDIS_RECEIVE_FILTER_CAPABILITIES с включенными в настоящее время возможностями оборудования фильтрации получения.
Драйвер инициализирует структуру NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES и задает элемент CurrentReceiveFilterCapabilities указателем на структуру NDIS_RECEIVE_FILTER_CAPABILITIES .
Драйвер мини-порта вызывает функцию NdisMSetMiniportAttributes и задает параметру MiniportAttributes указатель на структуру NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES .
При переопределяющихся драйверах протоколов и фильтров не нужно отправлять запросы OID OID_RECEIVE_FILTER_CURRENT_CAPABILITIES. NDIS предоставляет включенные в настоящее время возможности фильтрации получения для этих драйверов следующим образом:
NDIS предоставляет включенные в настоящее время возможности фильтрации получения базового сетевого адаптера для более лежащих драйверов протокола в элементе ReceiveFilterCapabilities структуры NDIS_BIND_PARAMETERS во время операции привязки.
NDIS предоставляет включенные в настоящее время возможности фильтрации получения базового сетевого адаптера для избыточных драйверов фильтров в члене ReceiveFilterCapabilitiesструктуры NDIS_FILTER_ATTACH_PARAMETERS во время операции присоединения.
Коды состояния возврата
NDIS обрабатывает запрос OID OID_RECEIVE_FILTER_CURRENT_CAPABILITIES для драйверов мини-портов и возвращает один из следующих кодов состояния:
NDIS_STATUS_SUCCESS
Запрос успешно выполнен. InformationBuffer указывает на структуру NDIS_RECEIVE_FILTER_CAPABILITIES.
NDIS_STATUS_PENDING
Запрос ожидает завершения. NDIS передает окончательный код состояния и результаты обработчику завершения запроса OID вызывающего объекта после завершения запроса.
NDIS_STATUS_INVALID_LENGTH
Буфер сведений был слишком коротким. NDIS задает data. QUERY_INFORMATION. Элемент BytesNeeded в NDIS_OID_REQUEST структуру до минимального требуемого размера буфера.
NDIS_STATUS_NOT_SUPPORTED
Сетевой адаптер не поддерживает фильтрацию приема.
NDIS_STATUS_FAILURE
Сбой запроса по другим причинам.
Требования
Версия |
Поддерживается в NDIS 6.20 и более поздних версиях. |
Заголовок |
Ntddndis.h (включая Ndis.h) |