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 равным нулю, и не возвращаются NDIS_SWITCH_PROPERTY_ENUM_INFO структуры.
Замечания
OID_SWITCH_PROPERTY_ENUM OID должен выдаваться только в том случае, если 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 (include Ndis.h) |
См. также
NDIS_SWITCH_PROPERTY_ENUM_INFO