OID_SWITCH_PORT_PROPERTY_ENUM

Статья
2025-03-13

Расширение 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 вниз стек расширяемого драйвера коммутатора.