NDIS_STATUS_RECEIVE_FILTER_CURRENT_CAPABILITIES

Драйвер минипорта выдает указание состояния NDIS_STATUS_RECEIVE_FILTER_CURRENT_CAPABILITIES при изменении возможностей фильтрации в данный момент.

примечание Это указание состояния должно быть сделано только мини-драйверами, поддерживающими фильтры получения NDIS.

Когда минипорт-драйвер указывает это состояние, он задает StatusBuffer член структуры NDIS_STATUS_INDICATION указатель на структуру NDIS_RECEIVE_FILTER_CAPABILITIES. Драйвер инициализирует эту структуру с включенными возможностями фильтра получения.

Замечания

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

• объединение пакетов NDIS. Дополнительные сведения об использовании фильтров получения в этом интерфейсе см. в управлении фильтрами получения пакетов.

• виртуализация одно корневых операций ввода-вывода (SR-IOV). Дополнительные сведения об использовании фильтров получения в этом интерфейсе см. в настройке фильтра получения навиртуального порта.

• очереди виртуальных машин (VMQ). Дополнительные сведения об использовании фильтров получения в этом интерфейсе см. в разделе Настройка и очистка фильтров VMQ.

Драйвер минипорта выдает указание состояния NDIS_STATUS_RECEIVE_FILTER_CURRENT_CAPABILITIES, если одно из следующих условий имеет значение true:

• В настоящее время возможности фильтра получения изменяются на одном сетевом адаптере. Например, фильтры получения можно включить или отключить с помощью приложения управления, разработанного независимым поставщиком оборудования (IHV).

• В настоящее время включено изменение возможностей фильтрации для одного или нескольких сетевых адаптеров, принадлежащих группе отказоустойчивой балансировки нагрузки (LBFO), управляемой промежуточным драйвером MUX. Дополнительные сведения см. в разделе промежуточных драйверов NDIS MUX.

Драйвер минипорта выполняет следующие действия, когда он выдает указание состояния NDIS_STATUS_RECEIVE_FILTER_CURRENT_CAPABILITIES:

1. Минипорт инициализирует структуру NDIS_RECEIVE_FILTER_CAPABILITIES с возможностями фильтра получения, которые в настоящее время включены в сетевом адаптере.

   Когда драйвер минипорта инициализирует элемент заголовка , он задает элемент typeзаголовка значение NDIS_OBJECT_TYPE_DEFAULT. Драйвер минипорта задает элемент редакции заголовка значение NDIS_RECEIVE_FILTER_CAPABILITIES_REVISION_2, а элемент Size — NDIS_SIZEOF_RECEIVE_FILTER_CAPABILITIES_REVISION_2.

2. Минипорт-драйвер инициализирует структуру NDIS_STATUS_INDICATION для указания состояния следующим образом:

   • Элемент StatusCode должен иметь значение NDIS_STATUS_RECEIVE_FILTER_CURRENT_CAPABILITIES.

   • Элемент StatusBuffer должен иметь адрес структуры NDIS_RECEIVE_FILTER_CAPABILITIES.

   • Элемент StatusBufferSize должен иметь значение sizeof(NDIS_RECEIVE_FILTER_CAPABILITIES).

3. Драйвер минипорта выдает указание состояния путем вызова NdisMIndicateStatusEx. Драйвер должен передать указатель на структуру NDIS_STATUS_INDICATION параметру StatusIndication.

примечание Драйверы переопределения могут использовать индикатор состояния NDIS_STATUS_RECEIVE_FILTER_CURRENT_CAPABILITIES для определения возможностей фильтра получения сетевого адаптера. Кроме того, эти драйверы также могут выдавать запросы OID OID_RECEIVE_FILTER_CURRENT_CAPABILITIES для получения возможностей фильтрации в данный момент.

Требования

См. также

NdisMIndicateStatusEx

NDIS_STATUS_INDICATION

NDIS_RECEIVE_FILTER_CAPABILITIES

OID_RECEIVE_FILTER_CURRENT_CAPABILITIES