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. Драйверы минипорта регистрируют эти возможности, выполнив следующие действия.
Драйвер инициализирует структуру 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 для драйверов мини-порта и возвращает один из следующих кодов состояния:
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 (include Ndis.h) |