Прочитать на английском

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

OID_RECEIVE_FILTER_QUEUE_PARAMETERS

  • Статья
  • 13.03.2025

Переопределяющие драйверы выдают запросы метода идентификатора объекта (OID) OID_RECEIVE_FILTER_QUEUE_PARAMETERS для получения текущих параметров конфигурации очереди получения. Элемент InformationBuffer структуры NDIS_OID_REQUEST содержит указатель на структуру NDIS_RECEIVE_QUEUE_PARAMETERS с идентификатором очереди типа NDIS_RECEIVE_QUEUE_ID. После успешного возврата из запроса метода OID InformationBuffer элемент структуры NDIS_OID_REQUEST содержит указатель на структуру NDIS_RECEIVE_QUEUE_PARAMETERS.

Переопределяющие драйверы выдают запросы наборов OID OID_RECEIVE_FILTER_QUEUE_PARAMETERS для изменения текущих параметров конфигурации очереди. Драйвер с превышением предоставляет указатель на структуру NDIS_RECEIVE_QUEUE_PARAMETERS в элементе InformationBuffer элемента структуры NDIS_OID_REQUEST.

Замечания

Превышение параметров драйверов выдает запросы на набор OID OID_RECEIVE_FILTER_QUEUE_PARAMETERS для изменения параметров одной или нескольких очередей получения. Запрос набора OID необязателен для драйверов минипорта NDIS 6.20 и более поздних версий. Однако запрос OID является обязательным для драйверов мини-порта, поддерживающих интерфейс очереди виртуальных машин (VMQ).

Примечание Только избыточный драйвер, выделенный очередью, может изменить параметры конфигурации путем выдачи запросов наборов OID OID_RECEIVE_FILTER_QUEUE_PARAMETERS.

Переопределяющий драйвер получил входное значение идентификатора очереди из предыдущего запроса OID_RECEIVE_FILTER_ALLOCATE_QUEUE метода OID.

После выделения очереди драйвер может изменить параметры конфигурации, имеющие соответствующий флаг изменения (NDIS_RECEIVE_QUEUE_PARAMETER_Xxx_CHANGED) в элементе Flags структуры NDIS_RECEIVE_QUEUE_PARAMETERS. Однако после выделения очереди драйвер чрезмерного изменения не может изменить параметры конфигурации, у которых нет соответствующего флага изменения.

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

NDIS обрабатывает запрос метода OID OID_RECEIVE_FILTER_QUEUE_PARAMETERS для драйверов мини-порта и возвращает один из следующих кодов состояния.

Код состояния Описание

NDIS_STATUS_SUCCESS

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

NDIS_STATUS_PENDING

Запрос ожидает завершения. NDIS передает окончательный код состояния и результаты обработчику завершения запроса OID вызывающего объекта после завершения запроса.

NDIS_STATUS_INVALID_LENGTH

Буфер информации был слишком коротким. NDIS задает DATA.METHOD_INFORMATION.элемент BytesNeed в структуре NDIS_OID_REQUEST к минимальному требуемому размеру буфера.

NDIS_STATUS_INVALID_PARAMETER

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

NDIS_STATUS_FAILURE

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

Требования

Версия

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

Заголовок

 Ntddndis.h (include Ndis.h)

См. также

NDIS_OID_REQUEST

NDIS_RECEIVE_QUEUE_PARAMETERS

OID_RECEIVE_FILTER_ALLOCATE_QUEUE