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


OID_PACKET_COALESCING_FILTER_MATCH_COUNT

NDIS выдает запрос OID OID_PACKET_COALESCING_FILTER_MATCH_COUNT для получения количества пакетов, кэшированных или объединенныхна сетевом адаптере. Сетевой адаптер объединяет полученные пакеты, если адаптер включен для объединения пакетов NDI S, а пакет соответствует фильтру получения.

Элемент InformationBuffer структуры NDIS_OID_REQUEST содержит указатель на выделенную вызывающим ULONG64 переменную. Перед успешной возвратом из запроса драйвер обновляет переменную ULONG64 с количеством пакетов, соответствующих фильтрам получения на сетевом адаптере.

Замечания

Начиная с NDIS 6.30 драйверы, поддерживающие объединение пакетов NDIS NDIS, должны поддерживать запросы запросов OID OID_PACKET_COALESCING_FILTER_MATCH_COUNT.

Примечание. Драйверы, поддерживающие виртуализацию одно корневых операций ввода-вывода (SR-IOV) или очереди виртуальных машин (VMQ) интерфейсы не требуются для поддержки запросов OID для этого OID-запроса.

Минипорт-драйвер, поддерживающий объединение пакетов, должен увеличивать счетчик ULONG64 для каждого полученного пакета, который был объединлен на сетевом адаптере. Пакеты объединяются, если они соответствуют фильтру получения, что чрезмерное скачивание драйверов на минипорт драйвер через запросы метода OID OID_RECEIVE_FILTER_SET_FILTER.

Драйвер возвращает значение этого счетчика при обработке запроса OID OID_PACKET_COALESCING_FILTER_MATCH_COUNT.

Драйвер минипорта не должен очистить счетчик после обработки запроса OID OID_PACKET_COALESCING_FILTER_MATCH_COUNT. Минипорт-драйвер должен очистить счетчик только в том случае, если выполняются следующие условия:

  • Драйвер минипорта обрабатывает запрос набора OID OID_PNP_SET_POWER для возобновления полного состояния NdisDeviceStateD0.

  • NDIS вызывает функцию минипорта MiniportResetEx для сброса базового сетевого адаптера.

Дополнительные сведения о объединениях пакетов см. в объединение пакетов NDIS.

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

Драйвер минипорта возвращает один из следующих кодов состояния для запроса метода OID OID_PACKET_COALESCING_FILTER_MATCH_COUNT:

NDIS_STATUS_SUCCESS
Запрос OID успешно завершен.

NDIS_STATUS_INVALID_LENGTH
Буфер информации был слишком коротким. Драйвер задает DATA. SET_INFORMATION. Элемент BytesNeeded в структуре NDIS_OID_REQUEST к минимальному размеру буфера, который требуется.

NDIS_STATUS_FAILURE
Запрос завершился ошибкой по другим причинам.

Требования

Версия

Поддерживается в NDIS 6.30 и более поздних версиях.

Заголовок

Ntddndis.h (include Ndis.h)

См. также

MiniportResetEx

NDIS_OID_REQUEST

OID_PNP_SET_POWER

OID_RECEIVE_FILTER_SET_FILTER