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


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

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

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

См. также


NDIS_OID_REQUEST

NDIS_SWITCH_PORT_ARRAY

NDIS_SWITCH_PORT_PARAMETERS

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