OID_RECEIVE_FILTER_HARDWARE_CAPABILITIES
Избыточные драйверы выдают запросы OID OID_RECEIVE_FILTER_HARDWARE_CAPABILITIES для получения аппаратных возможностей фильтрации приема сетевого адаптера.
После успешного возврата из запроса OID элемент InformationBuffer структуры NDIS_OID_REQUEST содержит указатель наструктуру NDIS_RECEIVE_FILTER_CAPABILITIES .
Комментарии
Фильтры получения NDIS используются в следующих интерфейсах NDIS:
Объединение пакетов NDIS. Дополнительные сведения об использовании фильтров получения в этом интерфейсе см. в разделе Управление фильтрами получения объединения пакетов.
Виртуализация одно корневых операций ввода-вывода (SR-IOV). Дополнительные сведения об использовании фильтров получения в этом интерфейсе см. в разделе Настройка фильтра получения для виртуального порта.
Очередь виртуальных машин (VMQ). Дополнительные сведения об использовании фильтров получения в этом интерфейсе см. в разделе Настройка и очистка фильтров VMQ.
Структура NDIS_RECEIVE_FILTER_CAPABILITIES содержит сведения о возможностях оборудования фильтрации приема сетевого адаптера. Эти возможности могут включать аппаратные возможности, которые в настоящее время отключены параметрами INF-файла или на странице Дополнительные свойства.
Примечание Все аппаратные возможности фильтрации приема сетевого адаптера возвращаются с помощью запроса OID OID_RECEIVE_FILTER_HARDWARE_CAPABILITIES, независимо от того, включена или отключена возможность.
Начиная с версии NDIS 6.20, драйверы минипорта регистрируют включенные в настоящее время аппаратные возможности фильтрации приема сетевого адаптера при вызове его функции MiniportInitializeEx . Драйверы miniport регистрируют эти возможности, выполнив следующие действия.
Драйвер инициализирует структуру NDIS_RECEIVE_FILTER_CAPABILITIES с аппаратными возможностями фильтрации приема.
Драйвер инициализирует структуру NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES и задает для элемента CurrentReceiveFilterCapabilities указатель на структуру NDIS_RECEIVE_FILTER_CAPABILITIES .
Драйвер мини-порта вызывает функцию NdisMSetMiniportAttributes и задает параметру MiniportAttributes указатель на структуру NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES .
Коды состояния возврата
NDIS обрабатывает запрос запроса OID OID_RECEIVE_FILTER_HARDWARE_CAPABILITIES для драйверов miniport и возвращает один из следующих кодов состояния:
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) |