Ескертпе
Бұл бетке кіру үшін қатынас шегін айқындау қажет. Жүйеге кіруді немесе каталогтарды өзгертуді байқап көруге болады.
Бұл бетке кіру үшін қатынас шегін айқындау қажет. Каталогтарды өзгертуді байқап көруге болады.
Расширение расширяемого коммутатора 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) |