OID_SWITCH_NIC_ARRAY
Расширение расширяемого коммутатора Hyper-V выдает запрос идентификатора объекта (OID) OID_SWITCH_NIC_ARRAY для получения массива. Каждый элемент в массиве задает параметры конфигурации виртуального сетевого адаптера, связанного с портом расширяемого коммутатора.
Если запрос OID успешно выполнен, элемент InformationBuffer структуры NDIS_OID_REQUEST содержит указатель на буфер. Этот буфер содержит следующие данные:
Структура NDIS_SWITCH_NIC_ARRAY , определяющая количество элементов в массиве. Эта структура также задает смещение до первого элемента в массиве.
Массив NDIS_SWITCH_NIC_PARAMETERS структур. Каждая из этих структур содержит сведения о сетевом адаптере, подключенном к порту расширяемого коммутатора.
Примечание Если сетевые адаптеры не подключены к портам расширяемого коммутатора, базовый край минипорта расширяемого коммутатора задает для элемента NumElements структуры NDIS_SWITCH_NIC_ARRAY значение 0. В этом случае NDIS_SWITCH_NIC_PARAMETERS структуры не возвращаются.
Комментарии
Идентификатор идентификатора OID_SWITCH_NIC_ARRAY должен выдаваться только после завершения активации расширяемого коммутатора Hyper-V. Дополнительные сведения см. в разделе Запросы к конфигурации расширяемого коммутатора Hyper-V .
Когда расширение обрабатывает возвращаемую NDIS_SWITCH_NIC_PARAMETERS структуру, оно не должно предполагать, что различные строковые элементы структуры NDIS_SWITCH_PORT_PARAMETERS , такие как NicFriendlyName, завершаются значением NULL. Типы данных для этих строковых элементов определяются IF_COUNTED_STRING структурой . Драйвер должен определить длину строки из значения элемента Length этой структуры.
Примечание Если строка заканчивается null, член Length не должен содержать завершающий символ NULL.
Коды состояния возврата
Базовый край мини-порта расширяемого коммутатора завершает запрос OID OID_SWITCH_NIC_ARRAY и возвращает один из следующих кодов состояния.
| Код состояния | Описание |
|---|---|
NDIS_STATUS_SUCCESS |
Запрос OID успешно завершен. |
NDIS_STATUS_INVALID_LENGTH |
Длина информационного буфера слишком мала для возврата NDIS_SWITCH_NIC_ARRAY и массива NDIS_SWITCH_NIC_PARAMETERS элементов. Базовый край мини-порта расширяемого коммутатора задает data. QUERY_INFORMATION. Элемент BytesNeeded в NDIS_OID_REQUEST структуру до минимального требуемого размера буфера. |
NDIS_STATUS_FAILURE |
Сбой запроса по другим причинам. |
Требования
Версия |
Поддерживается в NDIS 6.30 и более поздних версиях. |
Заголовок |
Ntddndis.h (включая Ndis.h) |