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) |