Поделиться через

OID_RECEIVE_FILTER_CURRENT_CAPABILITIES

  • Статья

Избыточные драйверы выдают запросы OID OID_RECEIVE_FILTER_CURRENT_CAPABILITIES для получения включенных в настоящее время возможностей фильтрации получения сетевого адаптера.

После успешного возврата из запроса OID элемент InformationBuffer структуры NDIS_OID_REQUEST содержит указатель на NDIS_RECEIVE_FILTER_CAPABILITIES структуру.

Комментарии

Фильтры получения NDIS используются в следующих интерфейсах NDIS:

Начиная с версии 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 6.20 и более поздних версиях.

Заголовок

 Ntddndis.h (включая Ndis.h)

См. также раздел

NDIS_BIND_PARAMETERS

NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES

NDIS_OID_REQUEST

NDIS_RECEIVE_FILTER_CAPABILITIES