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

OID_SWITCH_PROPERTY_ENUM

  • Статья

Расширение расширяемого коммутатора Hyper-V отправляет запрос метода идентификатора объекта (OID) OID_SWITCH_PROPERTY_ENUM для получения массива. Этот массив содержит подготовленные политики переключения, которые соответствуют указанным критериям. Каждый элемент в массиве задает свойства политики расширяемого коммутатора.

Элемент InformationBuffer структуры NDIS_OID_REQUEST содержит указатель на буфер. Этот буфер содержит следующие данные:

  • Структура NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS , указывающая параметры для перечисления расширяемой политики коммутатора.

  • Массив структур NDIS_SWITCH_PROPERTY_ENUM_INFO . Каждая из этих структур содержит сведения о расширяемой политике переключения.

    Примечание Если расширение не было подготовлено с экземплярами указанной политики расширяемого коммутатора, расширение устанавливает для элемента NumPropertiesструктуры NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS значение 0 и NDIS_SWITCH_PROPERTY_ENUM_INFO структуры не возвращаются.

Комментарии

Идентификатор идентификатора OID_SWITCH_PROPERTY_ENUM должен выдаваться только после завершения активации расширяемого коммутатора Hyper-V. Дополнительные сведения см. в разделе Запросы к конфигурации расширяемого коммутатора Hyper-V .

В отличие от запросов OID OID_SWITCH_PORT_PROPERTY_ENUM, расширению не требуется вызывать функции ReferenceSwitchXxx или DereferenceSwitchXxx , когда оно выдает OID_SWITCH_PROPERTY_ENUM запрос вниз стека драйвера расширяемого коммутатора.

Примечание Если расширение получает запрос метода OID OID_SWITCH_PROPERTY_ENUM, оно не должно выполнять запрос OID. Вместо этого он должен вызвать NdisFOidRequest , чтобы перенаправить запрос OID в стек драйвера расширяемого коммутатора.

Коды состояния возврата

Базовый край минипорта расширяемого коммутатора завершает запрос OID OID_SWITCH_PROPERTY_ENUM и возвращает один из следующих кодов состояния.

Код состояния Описание

NDIS_STATUS_SUCCESS

Запрос OID успешно завершен.

NDIS_STATUS_INVALID_LENGTH

Длина информационного буфера слишком мала, чтобы возвращать структуру NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS и массив элементов NDIS_SWITCH_PROPERTY_ENUM_INFO . Базовый край мини-порта расширяемого коммутатора задает data. METHOD_INFORMATION. Элемент BytesNeeded в NDIS_OID_REQUEST структуру до минимального требуемого размера буфера.

NDIS_STATUS_FAILURE

Сбой запроса по другим причинам.

Требования

Версия

Поддерживается в NDIS 6.30 и более поздних версиях.

Заголовок

 Ntddndis.h (включая Ndis.h)

См. также раздел

NDIS_OID_REQUEST

NDIS_SWITCH_PROPERTY_ENUM_INFO

NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS

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