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

OID_SWITCH_PORT_ARRAY

  • Статья

Расширение расширяемого коммутатора Hyper-V отправляет запрос на запрос идентификатора объекта (OID) OID_SWITCH_PORT_ARRAY для получения массива. Каждый элемент в массиве задает параметры конфигурации для порта расширяемого коммутатора.

Если запрос OID завершается успешно, элемент InformationBuffer структуры NDIS_OID_REQUEST содержит указатель на буфер. Этот буфер содержит следующие данные:

  • Структура NDIS_SWITCH_PORT_ARRAY , определяющая количество элементов в массиве.

  • Массив NDIS_SWITCH_PORT_PARAMETERS структур. Каждая из этих структур содержит сведения о порте расширяемого коммутатора.

    Примечание Если на расширяемом коммутаторе не было создано ни одного порта, драйвер устанавливает элемент NumElementsструктуры NDIS_SWITCH_PORT_ARRAY равным нулю, а NDIS_SWITCH_PORT_PARAMETERS структуры не возвращаются.

Комментарии

Идентификатор идентификатора OID_SWITCH_PORT_ARRAY должен выдаваться только после завершения активации расширяемого коммутатора Hyper-V. Дополнительные сведения см. в статье Запрос конфигурации расширяемого коммутатора Hyper-V .

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

Примечание Если строка заканчивается null, член Length не должен содержать завершающий символ NULL.

Коды состояния возврата

Базовая граница мини-порта расширяемого коммутатора завершает запрос OID OID_SWITCH_PORT_ARRAY и возвращает один из следующих кодов состояния.

Код состояния Описание

NDIS_STATUS_SUCCESS

Запрос OID успешно завершен.

NDIS_STATUS_INVALID_LENGTH

Длина информационного буфера слишком мала, чтобы вернуть NDIS_SWITCH_PORT_ARRAY и его массив элементов NDIS_SWITCH_PORT_PARAMETERS . Базовый край мини-порта расширяемого коммутатора задает data. QUERY_INFORMATION. Элемент BytesNeeded в NDIS_OID_REQUEST структуру до минимального требуемого размера буфера.

NDIS_STATUS_FAILURE

Сбой запроса по другим причинам.

Требования

Версия

Поддерживается в NDIS 6.30 и более поздних версиях.

Заголовок

 Ntddndis.h (включая Ndis.h)

См. также раздел

NDIS_OID_REQUEST

NDIS_SWITCH_PORT_ARRAY

NDIS_SWITCH_PORT_PARAMETERS

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