Настройка параметров Device-Specific

Ожидается, что большинство удаленных устройств NDIS будут работать хорошо без необходимости настройки параметров на узле. Однако могут возникать случаи, когда для правильной сетевой работы требуется определенная конфигурация на узле. Если устройство поддерживает настраиваемые параметры, оно должно включить следующий необязательный OID в список поддерживаемых идентификаторов OID, которые оно сообщает в ответ на запрос OID_GEN_SUPPORTED_LIST:

#define OID_GEN_RNDIS_CONFIG_PARAMETER 0x0001021B

Если устройство поддерживает OID OID_GEN_RNDIS_CONFIG_PARAMETER , узел использует его для установки параметров устройства вскоре после того, как устройство переходит в состояние, инициализированное remote NDIS из неинициализированного состояния. Узел отправляет на устройство ноль или более REMOTE_NDIS_SET_MSGs с OID_GEN_RNDIS_CONFIG_PARAMETER в качестве значения OID для установки. Каждая такая REMOTE_NDIS_SET_MSG соответствует одному параметру устройства, который настроен на узле.

InformationBuffer, связанный с каждым из таких REMOTE_NDIS_SET_MSG, имеет следующий формат. Обратите внимание, что значения Offset относятся к началу информационного буфера.

Offset	Размер	Поле	Описание
0	4	ParameterNameOffset	Указывает смещение в байтах от начала поля ParameterNameOffset, в котором находится строка символов Юникода, представляющая имя параметра. Строка не содержит признак конца NULL.
4	4	ParameterNameLength	Указывает длину байтов строки имени параметра.
8	4	ParameterType	Указывает тип данных значения параметра. Это одно из следующих значений: 0 — числовое значение; 2 — строковое значение.
12	4	ParameterValueOffset	Задает смещение в байтах от начала поля ParameterNameOffset, в котором находится значение параметра.
16	4	ParameterValueLength	Указывает длину байтов значения параметра.

Устройство отправляет REMOTE_NDIS_SET_CMPLT в ответ на каждое REMOTE_NDIS_SET_MSG после применения значения параметра. Если параметр является допустимым, он возвращает состояние RNDIS_STATUS_SUCCESS в ответе. Если параметр недопустим и устройство не может применить полезное значение по умолчанию для этого параметра, устройство возвращает соответствующее значение состояния ошибки (см. раздел о значениях состояния). Если возвращается состояние ошибки, узел инициирует процесс остановки устройства.

Параметры для конкретных устройств должны быть настроены в реестре Windows. Ключи, определяющие значения параметров, обычно создаются в реестре во время установки устройства. Список ключей, сведения о типах, значения по умолчанию и необязательный диапазон допустимых значений указываются в INF-файле для устройства. Дополнительные сведения об использовании INF для настройки параметров конфигурации в реестре для сетевых устройств см. в пакете средств разработки драйверов Windows 2000 (DDK).