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


OID_SWITCH_PARAMETERS

Расширение расширяемого коммутатора Hyper-V отправляет запрос идентификатора объекта (OID) OID_SWITCH_PARAMETERS для получения данных конфигурации расширяемого коммутатора.

Если запрос OID завершается успешно, элемент InformationBuffer структуры NDIS_OID_REQUEST содержит указатель на структуру NDIS_SWITCH_PARAMETERS .

Комментарии

Когда расширение обрабатывает возвращаемую NDIS_SWITCH_PARAMETERS структуру, оно не должно предполагать, что различные строковые элементы структуры NDIS_SWITCH_PARAMETERS , такие как SwitchName, завершаются значением NULL. Типы данных для этих строковых элементов определяются IF_COUNTED_STRING структурой . Расширение должно определять длину строки из значения элемента Length данной структуры.

Примечание Если строка заканчивается null, член Length не должен содержать завершающий символ NULL.

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

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

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

NDIS_STATUS_SUCCESS

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

NDIS_STATUS_INVALID_LENGTH

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

NDIS_STATUS_FAILURE

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

Требования

Версия

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

Заголовок

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

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


NDIS_OID_REQUEST

NDIS_SWITCH_PARAMETERS

NdisFOidRequest