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

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 равно нулю. В этом случае не возвращаются NDIS_SWITCH_NIC_PARAMETERS структуры.

Замечания

OID_SWITCH_NIC_ARRAY OID должен выдаваться только в том случае, если Hyper-V расширяемый коммутатор завершил активацию. Дополнительные сведения см. в запроса Hyper-V расширяемой конфигурации коммутатора.

При обработке возвращаемой структуры NDIS_SWITCH_NIC_PARAMETERS расширение не должно предполагать, что различные строковые члены структуры NDIS_SWITCH_PORT_PARAMETERS, такие как NicFriendlyName, завершаются значением NULL. Типы данных для этих элементов строки определяются структурой IF_COUNTED_STRING. Драйвер должен определить длину строки из значения элемента Length этой структуры.

Примечание Если строка завершается null, элемент длины не должен включать заканчивающийся символ 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 (include Ndis.h)

См. также

NDIS_OID_REQUEST

NDIS_SWITCH_NIC_ARRAY

NDIS_SWITCH_NIC_PARAMETERS

запрос конфигурации Hyper-V расширяемого коммутатора