OID_SWITCH_PORT_PROPERTY_ENUM
Расширение расширяемого коммутатора Hyper-V выдает запрос метода идентификатора объекта (OID) OID_SWITCH_PORT_PROPERTY_ENUM для получения массива. Этот массив содержит подготовленные политики портов, которые соответствуют заданным критериям. Каждый элемент в массиве задает свойства политики для указанного порта расширяемого коммутатора.
Элемент InformationBuffer структуры NDIS_OID_REQUEST содержит указатель на буфер. Этот буфер содержит следующие данные:
Структура NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS , указывающая параметры перечисления политики указанного порта.
Массив структур NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO . Каждая из этих структур содержит сведения о свойствах политики портов расширяемого коммутатора.
Примечание Если элемент NumPropertiesструктуры NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS равен нулю, NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO структуры не возвращаются.
Комментарии
Перед выполнением запроса метода OID OID_SWITCH_PORT_PROPERTY_ENUM расширение расширяемого коммутатора должно следовать следующим рекомендациям:
Расширение может выдавать запрос OID_SWITCH_PORT_PROPERTY_ENUM только после того, как граница протокола расширяемого коммутатора выдает запрос OID_SWITCH_PORT_CREATE и до выполнения запроса OID_SWITCH_PORT_TEARDOWN .
Расширение должно вызвать ReferenceSwitchPort перед вызовом NdisFOidRequest для выдачи запроса OID_SWITCH_PORT_PROPERTY_ENUM. Это гарантирует, что указанный порт не будет удален до завершения запроса OID.
После завершения запроса OID расширение должно вызвать DereferenceSwitchPort. Расширение должно вызывать эту функцию независимо от того, был ли выполнен запрос OID с помощью NDIS_STATUS_SUCCESS.
Идентификатор OID_SWITCH_PORT_PROPERTY_ENUM OID должен быть выдан только после завершения активации расширяемого коммутатора Hyper-V. Дополнительные сведения см. в статье Запрос конфигурации расширяемого коммутатора Hyper-V .
Примечание Если расширение получает запрос метода OID OID_SWITCH_PORT_PROPERTY_ENUM, оно не должно завершить запрос OID. Вместо этого он должен вызвать NdisFOidRequest , чтобы перенаправить запрос OID вниз по стеку драйверов расширяемого коммутатора.
Коды состояния возврата
Базовая граница мини-порта расширяемого коммутатора завершает запрос OID OID_SWITCH_PORT_PROPERTY_ENUM и возвращает следующий код состояния.
| Код состояния | Описание |
|---|---|
NDIS_STATUS_SUCCESS |
Запрос OID успешно завершен. |
Требования
Версия |
Поддерживается в NDIS 6.30 и более поздних версиях. |
Заголовок |
Ntddndis.h (включая Ndis.h) |
См. также раздел
NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO
NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS