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

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 .

Коды состояния возврата

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)

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

NDIS_BIND_PARAMETERS

NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES

NDIS_OID_REQUEST

NDIS_RECEIVE_FILTER_CAPABILITIES