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) |