OID_RECEIVE_FILTER_QUEUE_PARAMETERS
Избыточные драйверы выдают запросы метода идентификатора объекта (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 для изменения текущих параметров конфигурации очереди. Драйвер overlying предоставляет указатель на структуру 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 метода OID_RECEIVE_FILTER_ALLOCATE_QUEUE .
После выделения очереди драйвер может изменить параметры конфигурации, имеющие соответствующий флаг изменения (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. Элемент BytesNeeded в NDIS_OID_REQUEST структуру до минимального требуемого размера буфера. |
NDIS_STATUS_INVALID_PARAMETER |
Сбой запроса, так как он попытался включить возможность, которую не поддерживает базовый сетевой адаптер. |
NDIS_STATUS_FAILURE |
Сбой запроса по другим причинам. |
Требования
Версия |
Поддерживается в NDIS 6.20 и более поздних версиях. |
Заголовок |
Ntddndis.h (включая Ndis.h) |