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. Драйверы минипорта регистрируют эти возможности, выполнив следующие действия.

1. Драйвер инициализирует структуру NDIS_RECEIVE_FILTER_CAPABILITIES с включенным в данный момент возможностями фильтрации оборудования.

2. Драйвер инициализирует структуру NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES и задает элемент CurrentReceiveFilterCapabilities указателем на структуру NDIS_RECEIVE_FILTER_CAPABILITIES.

3. Драйвер минипорта вызывает функцию 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_BIND_PARAMETERS

NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES

NDIS_OID_REQUEST

NDIS_RECEIVE_FILTER_CAPABILITIES