OID_RECEIVE_FILTER_ENUM_QUEUES
Переопределяющие драйверы и приложения пользовательского режима выдают запросы идентификатора объекта (OID) OID_RECEIVE_FILTER_ENUM_QUEUES для получения списка всех очередей получения, выделенных на сетевом адаптере.
После успешного возврата из запроса OID InformationBuffer член структуры NDIS_OID_REQUEST содержит указатель на структуру NDIS_RECEIVE_QUEUE_INFO_ARRAY, за которой следует NDIS_RECEIVE_QUEUE_INFO структура для каждого фильтра.
Замечания
NDIS получила информацию из внутреннего кэша данных, полученных из OID_RECEIVE_FILTER_ALLOCATE_QUEUE и OID_RECEIVE_FILTER_QUEUE_PARAMETERS запросов OID.
Переопределяющие драйверы и приложения в пользовательском режиме выдают запросы OID OID_RECEIVE_FILTER_ENUM_QUEUES для перечисления очередей получения в сетевом адаптере.
Если драйвер протокола выдает запрос, тип запроса внутри структуры NDIS_OID_REQUEST устанавливается для NdisRequestQueryInformation, и этот OID возвращает массив всех очередей получения, выделенных драйвером протокола сетевого адаптера. Если приложение в пользовательском режиме выпустило запрос, тип запроса внутри структуры NDIS_OID_REQUEST имеет значение NdisRequestQueryStatistics, и этот OID возвращает массив сведений для всех очередей получения на сетевом адаптере.
Коды состояния возврата
NDIS обрабатывает запрос запроса OID OID_RECEIVE_FILTER_ENUM_QUEUES для драйверов мини-порта и возвращает один из следующих кодов состояния.
| Код состояния | Описание |
|---|---|
NDIS_STATUS_SUCCESS |
Запрос успешно завершен. InformationBuff er указывает на структуру NDIS_RECEIVE_QUEUE_INFO_ARRAY. |
NDIS_STATUS_PENDING |
Запрос ожидает завершения. NDIS передает окончательный код состояния и результаты обработчику завершения запроса OID вызывающего объекта после завершения запроса. |
NDIS_STATUS_INVALID_LENGTH |
Буфер информации был слишком коротким. NDIS задает DATA.METHOD_INFORMATION.элемент BytesNeededed в структуре NDIS_OID_REQUEST до минимального размера буфера, который требуется. |
NDIS_STATUS_FAILURE |
Запрос завершился ошибкой по другим причинам. |
Требования
Версия |
Поддерживается в NDIS 6.20 и более поздних версиях. |
Заголовок |
Ntddndis.h (include Ndis.h) |