OID_GEN_ISOLATION_PARAMETERS
NDIS и вышестоящие драйверы выдают запрос идентификатора объекта (OID) OID_GEN_ISOLATION_PARAMETERS для получения параметров конфигурации (изоляции) мультитенантности, заданных на порту сетевого адаптера виртуальной машины.
Хотя каждый домен маршрутизации настраивается отдельно для порта, этот OID возвращает параметры для всех доменов маршрутизации в одном запросе.
Драйвер с превышением должен выдавать этот идентификатор идентификатора в два этапа:
- Io запрашивает требуемый размер буфера, выполняет запрос OID с элементом Size элемента Headerструктуры NDIS_ISOLATION_PARAMETERS, для NDIS_SIZEOF_NDIS_ISOLATION_PARAMETERS_REVISION_1. (См . NDIS_STATUS_INVALID_LENGTH ниже.)
- Выпустите OID с InformationBuffer требуемого размера.
Если запрос OID успешно выполнен, элемент InformationBuffer структуры NDIS_OID_REQUEST содержит указатель на буфер. Этот буфер содержит следующие данные по порядку:
Структура NDIS_ISOLATION_PARAMETERS
Одна или несколько структур NDIS_ROUTING_DOMAIN_ENTRY , по одной для каждого домена маршрутизации
Одна или несколько NDIS_ROUTING_DOMAIN_ISOLATION_ENTRY структур, сгруппированных по домену маршрутизации
В каждой NDIS_ROUTING_DOMAIN_ENTRY структуре член FirstIsolationInfoEntryOffset содержит смещение от начала буфера сведений об идентификаторе (т. е. начала буфера, на который указывает элемент InformationBufferструктуры NDIS_OID_REQUEST ) до первого NDIS_ROUTING_DOMAIN_ISOLATION_ENTRY для этого домена маршрутизации. Смещение элемента NextIsolationInfoEntryOffset последней структуры в списке равно нулю.
Если в сетевом адаптере виртуальной машины не заданы параметры конфигурации с несколькими арендаторами, драйвер мини-порта сетевого адаптера задает data. QUERY_INFORMATION. BytesWritten член NDIS_OID_REQUEST структуру до нуля и возвращает NDIS_STATUS_SUCCESS. В этом случае это данные в data. QUERY_INFORMATION. Элемент InformationBuffer не изменяется драйвером мини-порта.
Комментарии
Коды состояния возврата
Драйвер минипорта сетевого адаптера виртуальной машины возвращает один из следующих кодов состояния для этого запроса OID:
| Код состояния | Описание |
|---|---|
NDIS_STATUS_SUCCESS |
Запрос OID успешно завершен. |
NDIS_STATUS_INVALID_LENGTH |
Длина буфера сведений слишком мала для возврата запрошенных сведений. Драйвер минипорта сетевого адаптера виртуальной машины задает data. METHOD_INFORMATION. Элемент BytesNeeded в NDIS_OID_REQUEST структуру до необходимого минимального размера буфера в байтах. |
NDIS_STATUS_FAILURE |
Сбой запроса по другим причинам. |
Требования
Версия |
Поддерживается в NDIS 6.40 и более поздних версиях. |
Заголовок |
Ntddndis.h (включая Ndis.h) |